eh 


9 re 还 一 四 
语言 实战 | 
G0 


IN ACTION 


William Kennedy 

[ 美 ] Brian Ketelsen 车 
Erik St. Martin 

李 兆 海 译 

谢 孟 军 审 校 


加 中 国 工 信 出 版 集团 移入 民 邮 电 出 版 社 


POSTS & TELECOM PRESS 





第 1] 童 关于 Go 语言 的 介绍 





LL 管理 

1.2 你 好 ，Go 

介绍 Go Playground 

1.3 小 结 

第 2 章 快速 开始 一 个 Go 程 
2.1 程序 活检 

2.2 main 包 

2.3 search 包 

2.3.1 Search.go 

2.3.2 feed.go 

2.3.3 match.go/default.go 
2.4 RSS 几 配 妖 

2.5 小 结 

第 3 章 0 工具 链 

3.1 所 

2 惯 僵 

3.1.2 main 包 

3.2 导入 








je “不 


| ner 








版 权 信息 


书 名 : Go 语言 实战 
ISBN: 978-7-115-44535-3 
本 书 由 人 民 邮 电 出 版 社 发 行 数字 版 。 版 权 所 有 ， 侵 权 必 完 





您 购买 的 人 民 邮 电 出 版 社 电 子 书 仅 供 您 个 人 使 用 ， 未 经 授权 ， 不 得 
以 任何 方式 复制 和 传播 本 书 内 容 。 


我 们 愿意 相信 读者 具有 这 样 的 恨 知 和 和 觉悟， 与 我 们 共同 保护 知识 产 
汉 


如 采购 天 省 有 侵权 行为， 我 们 可 能 对 该 用 户 实 施 包括 但 不 限于 关闭 
该 帐号 等 维权 措施 ， 并 可 能 退 完 法 律 责 任 。 

















著 [ 美 ] William Kennedy Brian Ketelsen Erik St. Martin 
译 李 光 海 
审 校 谢 了 各 军 
责任 编辑 杨 海 玲 


人 民 邮 电 出 版 社 出 版 发 行 ”北京 市 丰台 区 成 寿 寺 路 11 号 
邮编 “100164 ”电子 邮件 ”315@ptpress.com.cn 

网 址 ”http://www.ptpress.com.cn 

读者 服务 热线 : (010)81055410 


反 盗 版 热线 : (010)81055315 


版权 声明 


Original English language edition, entitled Co in Action by William 
Kennedy, Brian Ketelsen, and Erik St. Martin published by Manning 
Publications Co., 209 Bruce Park Avenue, Greenwich, CT 06830. Copyright 
©2016 by Manning Publications Co. 


Simplified Chinese-language edition copyright ©2017 by Posts & 
Telecom Press. All rights reserved. 


本 书 中 文 简体 字 版 由 Manning Publications Co. 授 权 人 民 邮 电 出 版 社 
独家 出 版 。 未 经 出 版 者 书面 许可 ， 不 得 以 任何 方式 复制 或 抄袭 本 书 内 
容 。 











版 权 所 有 ， 侵 权 必 和 完 。 


内 容 拓 要 


Go 语言 结合 了 底层 系统 语言 的 能 力 以 及 现代 语言 的 高 级 特性 ， 引 
在 降低 构建 简单 、 可 靠 、 高 效 软件 的 门槛 。 本 书 同 读者 提供 一 个 专注 、 
全 面 且 符合 语言 习惯 的 视角 。 本 书 同时 关注 语言 的 规范 和 实现 ， 涉 及 的 
内 容 包括 语法 、 类 型 系统 、 并 发 、 管 道 、 测 试 ， 以 及 其 他 一 些 主题 。 








本 书 是 写 给 有 其 他 编程 语言 基础 且 有 一 定 开 发 经 验 的 、 想 学 Go 语 
言 的 中 级 开发 者 的 。 对 于 刚 开 始 要 学 习 Go 语 言 和 想 要 深入 了 解 Go 语言 
内 部 实现 的 人 来 说 ， 本 书 部 是 最 佳 的 选择 。 





译 痢 序 


Go 语言 是 由 谷歌 公司 在 2007 年 开始 开发 的 一 门 语言 ， 目 的 是 能 在 
多 核心 时 代 高 效 编写 网 络 应 用 程序 。Go 语 言 的 创始 人 Robert 
Griesemer、Rob Pike 和 Ken Thompson 都 是 在 计算 机 发 展 过 程 中 作出 过 重 
要 页 献 的 人 。 目 从 2009 年 11 月 正式 公开 发 布 后 ，Go 语 言 迅速 席卷 了 整 
个 互联 网 后 端 开 发 领域 ， 其 社区 里 不 断 涌 现 出 类 似 vitess、Docker、 
etcd、Consul 等 重量 级 的 开源 项 目 。 


在 Go 语言 发 布 后 ， 我 就 被 其 简洁 、 强 大 的 特性 所 吸引 ， 并 于 2010 
年 开始 在 技术 聚会 上 宣传 Go 语言 ， 当 时 上 所 讲 的 题目 是 《Go 语言 : 互联 
网 时 代 的 C》 。 现 在 看 来 ，Go 语 言 确实 很 好 地 解决 了 互联 网 时 代 开 发 的 
痛 点 ， 而 且 入 门 门槛 不 高 ， 是 一 种 上 手 容易 、 威 力 强大 的 工具 。 试 想 一 
下 ， 不 需要 学 习 复 洒 的 异步 逮 辑 ， 使 用 习惯 的 顺序 方法 ， 就 能 实现 高 性 
0 000 0 
月 。 














本 书 是 国外 Go 社区 多 年 经 验 积 累 的 成 果 。 本 书 默认 读者 已 经 具有 
一 定 的 编程 基础 ， 希 望 更 好 地 使 用 Go 语言 。 全 书 以 示例 为 基础 ， 详 细 
介绍 了 Go 语言 中 的 一 些 比 较 深入 的 话题 。 对 于 有 经 验 的 程序 员 来 说 ， 
很 容易 通过 学 习 书 中 的 例子 来 解决 自己 实际 工作 中 过 到 的 问题 。 辅 以 文 
字 介 绍 ， 读 者 会 对 相关 问题 有 更 系统 的 了 解 和 认识 。 翻 译 过 程 中 我 尽量 
保持 了 原 书 的 叙述 方法 ， 并 加 强 了 叙述 逻辑 ， 和 希望 读者 会 觉得 清晰 易 
i 





在 翻译 本 书 的 过 程 中 ， 感 谢 人 民 邮 电 出 版 社 编辑 杨 海 玲 老 师 的 指导 
和 进度 安排 ， 让 本 书 能 按时 与 读者 见面 。 感 谢谢 巫 车 对 译 稿 的 审 校 ， 你 
的 润色 使 译文 读 起 来 流畅 了 很 多 。 尤 其 要 感谢 我 老婆 对 我 的 支持 ， 感 谢 
你 能 理解 我 出 于 热爱 才 会 “ 钾 司 ”在 计算 机 前 人 码 字 。 


最 后 ， 感 谢 读者 购买 此 书 。 希 望 读者 在 探索 Go 语言 的 着 路 上 ， 外 
够 译 受 到 和 我 一 样 的 乐趣 。 
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李 兆 海 ， 多 年 专注 村 后 端 分 布 式 网 络 服务 开发 ， 曾 使 用 过 多 个 流 
行 后 端 技术 和 相关 架构 实践 ， 是 Go 语言 和 Docker 的 早期 使 用 者 和 推广 
者 ，《 第 一 本 Docker 书 》 的 译 者 。 作 为 项 目 技术 人 负责 人 ， 成 功 开 太 了 百 


万 用 户 级 直播 系统 。 


py 


在 计算 机 科学 领域 ， 提 到 不 同 寻 常 的 人 ， 总 会 有 一 些 名 字 会 闪现 在 
你 的 脑海 中 。Rob Pike、Robert Griesmier 和 Ken Thompson 束 是 其 中 几 
个 。 他 们 3 个 人 负责 构建 过 UNIX、Plan 9、B、Java 的 JVM HotSpot、 
V8、Strongtalk 、Sawzall、Ed、Acme 和 UTF8， 此 外 还 有 很 多 其 他 的 
创造 。 在 2007 年 ， 这 3 个 人 并 在 一 起 ， 尝 试 一 个 伟大 的 想法 : 综合 他 们 
多 年 的 经 验 ， 借 鉴 已 有 的 语言 ， 来 创建 一 门 与 众 不同 的 、 全 新 的 系统 语 
言 。 他 们 随后 以 开源 的 形式 发 布 了 自己 的 实验 成 果 ， 并 将 这 种 语言 命名 
为 “<Go”。 如 果 按 照 现在 的 路 线 发 展 下 去 ， 这 门 语言 将 是 这 3 个 人 最 有 影 
啊 的 一 项 创造 。 


当 人 们 聚 在 一 起 ， 纯 粹 是 为 了 让 世界 变 得 更 好 的 时 候 ， 往 往 也 是 他 
们 处 于 最 佳 状态 的 时 候 。 在 2013 年 ， 为 了 围绕 Go 语言 构建 一 个 更 好 的 
社区 ，Brian 和 Erik 联 合成 立 了 Gopher Academy， 没 过 多 久 ，Bil 和 其 他 
一 些 有 类 似 想 法 的 人 也 加 入 进来 。 他 们 首先 注意 到 ， 社 区 需要 有 一 个 地 
方 可 以 在 线 聚 集 和 分 享 素 材 ， 所 以 他 们 在 slack 创 六 了 Go 讨论 版 和 
Gopher Academy 博 客 。 随 着 时 间 的 推移 ， 社 区 越 来 越 大 ， 他 们 创建 了 世 
界 上 第 一 个 全 球 Go 语 言 大 会 一 GopherCon。 随 着 与 社区 更 深入 地 交流 ， 
他 们 意识 到 还 需要 为 广大 想 学 习 这 门 新 语言 的 人 提供 一 些 资源 ， 所 以 他 
们 开始 着 手写 一 本 书 ， 就 是 现在 你 手 里 拿 的 这 本 书 。 


为 Go 社区 贡献 了 大 量 的 时 间 和 精力 的 3 位 作者 ， 出 于 对 Go 语言 社区 
的 热爱 写 就 了 这 本 书 。 我 曾 在 Bi 也 、Brian 和 Erik 身 边 ， 见 证 了 他 们 在 不 
同 的 环境 和 和 角色 (作为 Gopher Academy 博 客 的 编辑 ， 作 为 大 会 组 织 者 ， 
甚至 是 在 他 们 的 日 常 工作 中 ， 作 为 父亲 和 丈夫 ) 下， 都 会 认真 负责 地 撰 
写 和 修订 本 书 。 对 他 们 来 说 ， 这 不 仅仅 是 一 本 书 ， 也 是 对 他 们 心爱 的 语 
言 的 献礼 。 他 们 并 不 满足 于 写 就 一 本 “好 ?* 书 。 他 们 编写 、 审 校 ， 再 写 、 
再 修改 ， 再 三 推 殴 每 页 文字 、 每 个 例子 、 章 ， 直 到 认为 本 书 的 内 容 
配 得 上 他 们 珍视 的 这 门 语言 。 


离开 一 门 使 用 和 舒服、 掌握 熟练 的 语言 ， 去 学 习 一 门 不 仅 对 自己 来 
说 ， 对 整个 世界 来 说 都 是 全 新 的 语言 ， 是 需要 勇气 的 。 这 是 一 条 人 迹 罕 
至 ， 沿 途 充 满 bug， 只 有 少数 先行 者 画 悉 的 路 。 这 里 充满 了 意外 的 错 
误 ， 文 档 不 明确 或 者 缺失 ， 而 且 缺 少 可 以 拿 来 即 用 的 代码 库 。 这 是 拓 死 





























者 、 先 锋 才 会 选择 的 道路 。 如 果 你 正在 读 这 本 书 ， 那 么 你 可 能 正在 踏 上 
这 段 旅途 。 

本 书目 始 至 终 是 为 你 一 本 书 的 读者 精心 制作 的 一 本 探索 、 学 习 和 使 
用 Go 语言 的 简洁 而 全 面 的 指导 手册 。 在 全 世界 ， 你 也 不 会 找到 比 B 记 l、 
Brian 和 Erik 更 好 的 导师 了 。 我 非常 高 兴 你 能 开始 探索 Go 语言 的 优点 ， 期 
望 能 在 线 上 和 线 下 大 会 上 遇 到 你 。 


Steve Francia 


Go 语言 开发 者 ，Hugo、Cobra、Viper 和 SPF13-VIM 的 创建 人 


Q) 一 个 高 性 能 强 类 型 的 Smalltalk 实 现 。 译 者 注 
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采 言 


那 是 2013 年 10 月 ， 我 刚刚 花 几 个 月 的 时 间 写 完 GoingGo.net 博 客 ， 就 
接 到 了 Brian Ketelsen 和 Erik St. Martin 的 电话 。 他 们 正在 写 这 本 书 ， 问 我 
是 否 有 兴趣 参与 进来 。 我 立刻 抓 住 机 会 ， 参 与 到 写作 中 。 当 时 ， 作 为 一 
个 Go 语言 的 新 手 ， 这 是 我 进一步 了 解 这 门 语 言 的 好 机 会 。 毕 竟 ， 与 
Brian 和 Erik 一 起 工作 、 一 起 分 享 获得 的 知识 ， 比 我 从 构建 博客 中 学 到 的 
要 多 得 多 。 


完成 前 4 章 后 ， 我 们 在 Manning 早 期 访问 项 目 《MEAP) 中 发 布 了 这 
本 书 。 很 快 ， 我 们 收 到 了 来 目 语言 团队 成 员 的 邮件 。 这 位 成 员 对 很 多 细 
节 提 供 了 评审 意见 ， 还 附加 了 大 量 有 用 的 知识 、 意 见 、 豆 励 和 文 持 。 根 
据 这 些 评 审 意见 ， 我 们 决定 从 头 开始 重 写 第 2 音 ， 并 对 第 4 章 进 行 了 全 面 
修订 。 据 我 们 所 知 ， 对 整 革 进行 重 写 的 情况 并 不 少见 。 通 过 这 段 重 写 的 
经 历 ， 我 们 学 会 要 依靠 社区 的 帮助 来 完成 写作 ， 因 为 我 们 希望 能 立刻 得 
到 社区 的 支持 。 


目 那 以 后 ， 这 本 书 就 成 了 社区 努力 的 成 果 。 我 们 投入 了 大 量 的 时 间 
研究 每 一 章 ， 开 发 样 例 代 码 ， 并 和 社区 一 起 评审 、 讨 论 并 编辑 书 中 的 材 
料 和 代码 。 我 们 尽 了 最 大 的 努力 来 保证 本 书 在 技术 上 没有 错误 ， 让 代码 
符合 通用 习惯 ， 并 且 使 用 社区 认为 应 该 有 的 方式 来 教 Go 语言 。 同 时 ， 
我 们 也 融入 了 自己 的 思考 、 自 己 的 实践 和 上 自己 的 指导 方式 。 


我 们 希望 本 书 能 帮 你 学 习 Go 语 言 ， 不 仅 是 当下 ， 就 是 多 年 以 后 ， 
你 也 能 从 本 书 中 找到 有 用 的 东西 。Brian、Erik 和 我 总 会 在 线 上 帮助 那些 
0 
呼 吧 。 





























William Kennedy 


致谢 


我 们 花 了 18 个 月 的 时 间 来 写本 书 。 但 是 ， 离 开 下 面 这 些 人 的 文 持 ， 
我 们 不 可 能 完成 这 本 书 : 我 们 的 家 人 、 朋 友 、 同 学、 同事 以 及 导师 ， 整 
个 Go 社区 ， 还 有 我 们 的 出 厂商 Manning。 


当 你 开始 撰写 类 似 的 书 时 ， 你 需要 一 位 编辑 。 编 辑 不 仅 要 分 享 喜悦 
与 成 就 ， 而 且 要 不 惜 一 切 代价 ， 帮 你 渡 过 难关 。Jennifer Stout， 你 才华 
横 洲 ， 善 于 指导 ， 是 很 棒 的 朋友 。 感 谢 你 这 段 时 间 的 付出 ， 尤 其 是 在 我 
们 最 需要 你 的 时 候 。 感 谢 你 让 这 本 书 变 成 现实 。 还 要 感谢 为 本 书 的 开 友 
和 出 版 作出 贡献 的 Manning 的 其 他 人 。 


每 个 人 都 不 可 能 知晓 一 切 ， 所 以 需要 社区 里 的 人 付出 时 间 和 学 识 。 
感谢 Go 社区 以 及 所 有 参与 本 书 不 同 阶段 书稿 评审 并 提供 反馈 的 人 。 特 
别 感谢 Adam McKay、Alex Basile、Alex Jacinto、Alex Vidal、Anjan 
Bacchu、 Benoit Benedetti、Bill Katz、Brian Hetro、Colin Kennedy、 
Doug Sparling,、Jeffrey Lim、Jesse Evans、Kevin Jackson、Mark 
Fisher、 Matt Zulak、Paulo Pires、Peter Krey、Philipp K. Janert、Sam 
Zaydel 以 及 Thomas ORourke。 还 要 感谢 Jimmy Frasché， 他 在 出 版 前 对 
本 书 书稿 做 了 快速 、 准 确 的 技术 审 校 。 


这 里 还 需要 特别 感谢 一 些 人 。 


Kim Shrier， 从 最 开始 就 在 提供 评审 意见 ， 并 人 花 时 间 来 指导 我 们 。 
人 非常 感谢 。 因 为 你 ， 本 书 在 技术 上 达到 了 更 
了 的 境界 。 


Bill Hathaway 在 写 书 的 最 后 一 年 ， 深 入 参与 ， 并 矫正 了 每 一 章 。 你 
的 想法 和 意见 非常 宝贵 。 我 们 必须 给 予 B 齐 “第 9 章 合 著者 ”的 头衔 。 没 有 
Bi 的 参与 、 天 由 以 及 努力 ， 就 没有 这 一 章 的 存在 。 


我 们 还 要 特别 感谢 Cory Jacobson、Jeffery Lim 、Chetan Conikee 和 
Nan Xiao 为 本 书 持续 提供 了 评审 意见 和 指导 ， 感 谢 Gabriel Aszalos、 
Fatih Arslan、Kevin Gillette 和 Jason Waldrip 帮 助 评审 样 例 代 码 ， 还 要 特 
别 感 谢 Steve Francia 帮 我 们 作 序 ， 认 可 我 们 的 工作 。 











最 后 ， 我 们 真诚 地 感谢 我 们 的 家 人 和 朋友 。 为 本 书 付 出 的 时 间 和 代 
价 ， 总 会 影响 到 你 押 爱 的 人 。 





William Kennedy 


我 首先 要 感谢 Lisa， 我 美丽 的 妻子 ， 以 及 我 的 5 个 孩子 : Brianna、 
Melissa、Amanda、Jarrod 和 Thomas。Lisa， 我 知道 你 和 孩子 们 有 太 多 的 
日 夜 和 周末 ， 人 缺少 丈夫 和 父亲 的 陪伴 。 感 谢 你 让 我 这 段 时 间 全 力 投入 本 
蔬 的 工作 :我 受 你 人 要 你 们 每 一 个 人 5 


我 也 要 感谢 我 生意 上 的 伙伴 Ed Gonzalez、 创 意 经 理 Erick Zelaya， 
以 及 整个 Ardan 工 作 室 的 团队 。Ed， 感 谢 你 从 一 开始 就 文 持 我 。 没 有 
你 ， 我 就 无 法 完成 本 书 。 你 不 仅 是 生意 伙伴 ， 还 是 朋友 和 兄长 : 谢谢 
你 。Erick， 感 谢 你 为 我 、 为 公司 做 的 一 切 。 我 不 确定 没有 你 ， 我 们 还 能 
不 能 做 到 这 一 切 。 





Brian Ketelsen 


首先 要 感谢 我 的 家 人 在 我 写 书 的 这 4 年 间 付 出 的 耐心 。Christine、 
Nathan、Lauren 和 Evelyn， 感 谢 你 们 在 游泳 时 放 过 在 劳 边 椅子 上 写作 的 
我 ， 感 谢 你 们 相信 这 本 书 一 定 会 出 版 。 





Erik St. Martin 


我 要 感谢 我 的 未 婚 妻 Abby 以 及 我 的 3 个 孩子 Halie、Wyatt 和 Allie。 
感谢 你 们 对 我 花 大 量 时 间 写 书 和 组 织 会 议 如 此 耐心 和 理解 。 我 非常 爱 你 
们 ， 有 你 们 我 非常 幸运 。 


还 要 感谢 Bill Kennedy 为 本 书 付出 的 巨大 努力 ， 以 及 当 我 们 需要 他 
的 帮助 的 时 候 ， 他 总 是 立刻 想 办 法 组 织 GopherCon 来 满足 我 们 的 要 求 。 
还 要 感谢 整个 社区 出 力 评审 并 给 出 一 些 误 励 的话 。 





Go 是 一 门 开源 的 编程 语言 ， 目 的 在 于 降低 构建 简单 、 可 靠 、 高 效 
软件 的 门槛 。 尽 管 这 门 语言 借鉴 了 很 多 其 他 语言 的 思想 ， 但 是 任 借 目 身 
统一 和 目 然 的 表达 ，Go 程 序 在 本 质 上 完全 不 同 于 用 其 他 语言 编写 的 程 
序 。Go 平 衡 了 底层 系统 语言 的 能 力 ， 以 及 在 现代 语言 中 所 见 到 的 高 级 
特性 。 你 可 以 依靠 Go 语言 来 构建 一 个 非常 快捷 、 高 性 能 且 有 足够 控制 
力 的 编程 环境 。 使 用 Go 语言 ， 可 以 写 得 更 少 ， 做 得 更 多 。 


谁 应 该 读 这 本 书 


本 书 是 写 给 已 经 有 一 定 其 他 语言 编程 经 验 ， 并 且 想 学 习 Go 语 言 的 
中 级 开发 者 的 。 我 们 写 这 本 书 的 目的 是 ， 为 读者 提供 一 个 专注 、 全 面 且 
符合 语言 习惯 的 视角 。 我 们 同时 关注 语言 的 规范 和 实现 ， 涉 及 的 内 容 包 
括 语法 、 类 型 系统 ， 并 发 、 管 道 、 测 试 以 及 其 他 一 些 主题 。 我 们 相信 ， 
对 于 刚 开 始 学 Go 语言 的 人 ， 以 及 想 要 深入 了 解 这 门 语言 内 部 实现 的 人 
来 说 ， 本 书 都 是 极 佳 的 选择 。 











章节 速 唤 
本 书 由 9 章 组 成 ， 每 章 内 容 简 要 描述 如 下 。 


。 第 1 章 快 速 介绍 这 门 语言 是 什么 ， 为 什么 要 创造 这 门 语言 ， 以 及 这 

门 语言 要 解决 什么 问题 。 这 一 章 还 会 简要 介绍 一 些 Go 语 言 的 核心 

概念 ， 如 并 发 。 

第 2 章 引 导 你 完成 一 个 完整 的 Go 程序 ， 并 教 你 作为 Go 作为 一 门 语 言 

必须 提供 的 特性 。 

第 3 章 介 绍 打包 的 概念 ， 以 及 搭建 Go 工作 空间 和 开发 环境 的 最 佳 实 

第 4 章 展 示 Go 语 言 内 置 的 类 型 ， 即 数组 、 切 片 和 映射 。 还 会 解释 这 

些 数据 结构 背后 的 实现 和 机 制 。 

。 第 5 章 详 细 介 绍 Go 语 言 的 类 型 系统 ， 从 结构 体 类 型 到 具名 类 型 ， 再 
到 接口 和 类 型 租 套 。 这 一 半 还 会 展示 如 何 综合 利用 这 些 数 据 结 构 ， 





























用 简单 的 方法 来 构建 和 编写 复杂 的 程序 。 

第 6 章 深入 展示 Go 调度 器 、 并 发 和 管道 是 如 何 工作 的 。 这 一 章 还 将 

介绍 这 个 方面 背后 的 机 制 。 

第 7 章 基 于 第 6 章 的 内 容 ， 展 示 一 些 实际 开发 中 用 到 的 并 发 模式 。 你 

ee 以 及 如 何 利 用 池 来 
资源 。 

第 8 章 对 标准 库 进 行 探索 ， 深 入 介绍 3 个 包 ， 即 1og 、json 和 io 。 

这 一 章 专 门 介 绍 这 3 个 包 之 间 的 某 些 复杂 关系 。 

第 9 章 以 如 何 利 用 测试 和 基准 测试 框架 来 结束 全 书 。 读 者 会 学 到 如 

何 写 单元 测试 、 表 组 测试 以 及 基准 测试 ， 如 何在 文档 中 增加 示例 ， 

以 及 如 何 把 这 些 示例 当 作 测试 使 用 。 


关于 代码 


本 书 中 的 所 有 代码 都 使 用 等 冤 字 体 表示 ， 以 便 和 周围 的 文字 区 分 
开 。 在 很 多 代码 清单 中 ， 代 码 补 注释 是 为 了 说 明天 键 概念 ， 并 且 有 时 在 
正文 中 会 用 数字 编号 来 给 出 对 应 代码 的 其 他 信息 。 


本 书 的 源 代码 既 可 以 在 Manning 网 站 (www.manning.com/books/go- 
in-action)》 上 下 载 PD ， 也 可 以 在 
GitHub (https://github.com/goinaction/code ) 上 找到 这 些 源 代码 。 


读者 在 线 


购买 本 书后 ， 可 以 在 线 访问 由 Manning 出 版 社 提供 的 私有 论坛 。 在 
这 个 论坛 上 可 以 对 本 书 做 评论 ， 咨 询 技术 问题 ， 并 得 到 作者 或 其 他 读者 
的 帮助 。 通 过 浏览 器 访问 www.manning.com/books/go-in-action 可 以 访问 
并 订阅 这 个 论坛 。 这 个 网 页 还 提供 了 注册 后 如 何 访 问 论 坛 ， 论 坛 提供 什 
么 样 的 帮助 ， 以 及 论坛 的 规则 等 信息 。 

Manning 辐 读者 承诺 提供 一 个 读者 之 间 以 及 读者 和 作者 之 间 交 流 的 
场所 。Manning 并 不 承诺 作者 一 定 会 参与 ， 作 者 参与 论坛 的 行为 完全 出 
于 作者 自愿 〈 没 有 报酬 ) 。 我 们 建议 你 向 作者 提 一 些 有 挑战 性 的 问题 ， 
舍 则 可 能 提 不 起 作者 的 兴趣 。 


只 要 书 一 出 版 ， 作 者 在 线 论坛 以 及 早期 讨论 的 存档 就 可 以 在 出 版 商 

















的 网 站 上 获取 到 。 


天 于 作者 


William Kennedy (@goinggodotnet) 是 Ardan 工 作 室 的 管理 合伙 
人 。 这 家 工作 室 位 于 佛罗里达 州 迈阿密 ， 是 一 家 专注 移动 、Web 和 系统 
开发 的 公司 。 他 也 是 博客 GoingGo.net 的 作者 ， 迈 阿 密 Go 聚会 的 组 织 
者 。 从 在 培训 公司 Ardan Labs 开 始 ， 他 就 专注 于 Go 语言 教学 。 无 论 是 在 
当地 ， 还 是 在 线 上 ， 经 常 可 以 在 大 会 或 者 工作 坊 中 看 到 他 的 映 影 。 他 辟 
是 会 花 时 间 来 帮 那 些 想 获取 Go 语言 知识 、 写 作 博 客 、 编 码 拉 能 的 公司 
或 个 人 提升 到 更 高 的 水 平 。 


Brian Ketelsen ((@bketelsen) 是 XOR Data Exchange 的 CIO 和 联合 创 
始 人 。Brian 也 是 每 年 Go 语言 大 会 (GohperCon) 的 合 办 者 ， 同 时 也 是 
Gopher Academy 的 创立 者 。 作 为 专注 于 社区 的 组 织 ，Gopher Academy 一 
直 在 促进 Go 语言 的 发 展 和 对 Go 语言 开发 者 的 培训 。Brian 从 2010 年 就 开 
始 使 用 Go 语言 。 


Erik St. Martin ((@erikstmartin) 是 XOR Data Exchange 的 软件 开发 
总 监 。 他 所 在 的 公司 专注 于 大 数据 分 析 ， 最 早 在 得 克 萨 斯 州 奥斯汀 ， 后 
来 搬 到 了 佛罗里达 州 坦 帕 湾 。Erik 长 时 间 为 开源 软件 及 其 社区 做 贡献 。 
他 是 每 年 GopherCon 的 组 织 者 ， 也 是 坦 帕 湾 Go 聚会 的 组 织 者 。 他 非常 热 
爱 Go 语 言及 Go 语言 社区 ， 积 极 寻 求 促进 社区 成 长 的 新 方法 。 














Q 本 书 源 代码 也 可 以 从 www.epubit.com.cn 本 书 网 页 免费 下 载 。 


关于 封面 插图 


本 书 封面 插图 的 标题 为 “来 自 东 印度 的 人 ”。 这 幅 图 选 自 伦敦 的 
Thomas Jefferys 的 《A Collection of the Dresses of Different Nations, 
Ancient and Modermm》 (4 卷 )， 出 版 于 1757 年 到 1772 年 之 间 。 书 籍 首页 
说 明了 这 幅 画 的 制作 工艺 是 铀 版 雕刻 ， 手 工 上 色 ， 外 层 用 阿拉 伯 胶 做 保 
护 。Thomas Jefferys 〈1719 一 1771) 被 称 作 “地 理 界 的 乔治 三 世 国王 ”。 
作为 制图 者 ， 他 在 当时 英国 地 图 商 中 处 于 领先 地 位 。 他 为 政府 和 其 他 官 
员 雕 刻 和 印刷 地 图 ， 同 时 也 制作 大 量 的 商业 地 图 和 地 图 册 ， 尤 其 是 北美 
地 图 。 他 作为 地 图 制作 者 的 经 历 ， 点 燃 了 他 收集 各 地 风俗 服饰 的 兴趣 ， 
最 终 成 就 了 这 部 衣着 集 。 


对 遥远 大 陆 的 着 迷 以 及 对 旅行 的 乐趣 ， 是 18 世 纪 晚 期 才 兴 起 的 现 
象 。 这 类 收集 品 也 风行 一 时 ， 癌 实地 旅行 家 和 空想 旅行 家 们 介绍 各 地 的 
风俗 。jJefferys 的 画集 如 此 多 样 ， 生 动 地 回 我 们 描述 了 200 年 前 世界 上 不 
同 民族 的 独立 特征 。 从 那 之 后 ， 衣 着 的 特征 发 生 了 改变 ， 那 个 时 代 不 同 
地 区 和 国家 的 多 样 性 ， 也 逐渐 消失 。 现 在 ， 很 难 再 通过 本 地 居民 的 服饰 
来 区 分 他 们 所 在 的 大 陆 。 也 许 ， 从 乐观 的 方面 看 ， 现 在 不 同 地 区 的 人 ， 
在 文化 和 视觉 上 进行 了 更 多 的 交换 ， 拥 有 了 更 加 多 样 的 个 人 生活 方式 
至 少 在 知识 和 技术 生活 上 ， 更 加 多 样 而 有 趣 。 


在 很 难为 别人 描述 计算 机 书籍 的 时 候 ，Manning 创 造 性 地 将 两 个 世 
纪 以 前 不 同 地 区 的 多 样 性 ， 附 着 在 计算 机 行业 的 图 书 封面 上 ， 也 为 
Jeffreys 的 男 市 来 了 新 的 生命 。 

















第 1 章 ”关于 Go 语言 的 介绍 
本 章 主 要 内 容 


。 用 Go 语言 解决 现代 计算 难题 
。 使 用 Go 语言 工具 


计算 机 一 直 在 演化 ， 但 是 编程 语言 并 没有 以 同样 的 速度 演化 。 现 在 
的 手机 ， 内 置 的 CPU 核 数 可 能 都 多 于 我 们 使 用 的 第 一 台电 脑 。 高 性 能 服 
务 絮 拥有 64 核 、128 核 ， 甚 至 更 多 核 。 但 是 我 们 依旧 在 使 用 为 单 核 设计 
的 技术 在 编程 。 


编程 的 技术 同样 在 演化 。 大 部 分 程序 不 再 由 单个 开发 者 来 完成 ， 而 
古 由 处 于 不 同时 区 、 不 同时 间 段 工作 的 一 组 人 来 完成 。 大 项 目 被 分 解 为 
小 项 目 ， 指 派 给 不 同 的 程序 员 ， 程 序 员 开发 完成 后 ， 再 以 可 以 在 各 个 应 
用 程序 中 交叉 使 用 的 库 或 者 包 的 形式 ， 提 交 给 整个 团队 。 


如 今 的 程序 员 和 公司 比 以 往 更 加 信任 开源 软件 的 力量 。Go 语 言 是 
一 种 让 代码 分 享 更 容易 的 编程 语言 。Go 语言 自 带 一 些 工 具 ， 让 使 用 别 
人 写 的 包 更 容易 ， 并 且 Go 语言 也 让 分 享 自己 写 的 包 更 容易 。 


在 本 章 中 读者 会 看 到 Go 语言 区 别 于 其 他 编程 语言 的 地 方 。Go 语 言 
对 传统 的 面 癌 对 象 开发 进行 了 重新 思考 ， 并 且 提 供 了 更 高 效 的 复 用 代码 
的 手段 。Go 语 言 还 让 用 户 能 更 高 效 地 利用 昂 贯 服务 器 上 的 所 有 核心 ， 
而 且 它 编译 大 型 项 目的 速度 也 很 快 。 


在 阅读 本 章 时 ， 读 者 会 对 影响 Go 语言 形态 的 很 多 决定 有 一 些 认 
识 ， 从 它 的 并 发 模型 到 快 如 内 电 的 编译 妖 。 我 们 在 前 言 中 提 到 过 ， 这 里 
再 强调 一 次 : 这 本 书 是 写 给 已 经 有 一 定 其 他 编程 语言 经 验 、 想 学 习 Go 
语言 的 中 级 开发 者 的 。 本 书 会 提供 一 个 专注 、 全 面 且 符 合 习惯 的 视角 。 
我 们 同时 专注 语言 的 规范 和 实现 ， 涉 及 的 内 容 包 括 语法 、Go 语 言 的 类 
型 系统 、 并 发 、 通 道 、 测 试 以 及 其 他 一 些 非常 广泛 的 主题 。 我 们 相信 ， 
对 刚 开 始 要 学 习 Go 语 言 和 想 要 深入 了 解 语言 内 部 实现 的 人 来 说 ， 本 书 
都 是 最 佳 选择 。 


本 书 示 例 中 的 源 代 码 可 以 在 https://github.com/goinaction/code 下 



































载 。 


我 们 希望 读者 能 认识 到 ，Go 语 言 附带 的 工具 可 以 让 开发 人 员 的 生 
活 变 得 更 简单 。 最 后 ， 读 者 会 意识 到 为 什么 那么 多 开发 人 员 用 Go 语言 
来 构建 自己 的 新 项 目 。 


1.1 用 Go 解决 现代 编程 难题 


Go 语言 开发 团队 花 了 很 长 时 间 来 解决 当今 软件 开 有 人员 面 对 的 问 
题 。 开 发 人 员 在 为 项 目 选择 语言 时 ， 不 得 不 在 快速 开发 和 性 能 之 间 做 出 
选择 。C 和 C++ 这 类 语言 提供 了 很 快 的 执行 速度 ， 而 Ruby 和 Python 这 关 
语言 则 擅长 快速 开发 。Go 语 言 在 这 两 者 间架 起 了 桥 染 ， 不 仅 提 供 陨 
性 能 的 语言 ， 同 时 也 让 开发 更 快速 。 


在 探索 Go 语言 的 过 程 中 ， 读 者 会 看 到 精心 设计 的 特性 以 及 简洁 的 
语法 。 作 为 一 门 语言 ，Go 不 仅 定义 了 能 做 什么 ， 还 定义 了 不 能 做 什 
么 。Go 语 言 的 语法 简洁 到 只 有 儿 个 关键 字 ， 便 于 记忆 。Go 语 言 的 编译 
铝 速 度 非常 快 ， 有 时 甚至 会 让 人 感觉 不 到 在 编译 。 所 以 ，Go 开 发 者 能 
显赫 减少 等 竺 项 目 构建 的 时 间 。 因 为 Go 语言 内 置 并 及 机 制 ， 所 以 不 用 
被 迫使 用 特定 的 线程 订 ， 束 能 让 软件 扩展 ， 使 用 更 多 的 资源 。Go 语 言 
的 类 型 系统 简单 且 高 效 ， 不 需要 为 面 问 对 象 开 发 付出 额外 的 心 知 ， 让 开 
发 者 能 专注 于 代码 复 用 。Go 语 言 还 自 带 垃圾 回收 器 ， 不 需要 用 户 自 己 
管理 内 存 。 让 我 们 快速 浏览 一 下 这 些 关 键 特性 。 


1.1.1 开发 速度 
编译 一 个 大 型 的 C 或 者 C++ 项 目 所 花费 的 时 间 甚 至 比 去 喝 杯 咖啡 的 


时 间 还 长 。 图 1-1 是 XKCD 中 的 一 幅 漫 画 ， 描 述 了 在 办 公 室 里 开小差 的 经 
典 借口 。 

















合理 地 逃避 工作 最 常用 的 借口 : 


正 编译 呢 1 “ 
二 


N 


人 39 巴 ， 你 们 继续 。” 





图 1-1 努力 工作 ? (来 自 XKCD) 


Go 语言 使 用 了 更 加 智能 的 编译 器 ， 并 简化 了 解决 依赖 的 算法 ， 最 
终 提 供 了 更 快 的 编译 速度 。 编 译 Go 程 序 时 ， 编 译 器 只 会 关注 那些 直接 
被 引用 的 库 ， 而 不 是 像 Java、C 和 C++ 那样 ， 要 遍历 依赖 链 中 所 有 依赖 
的 库 。 因 此 ， 很 多 Go 程序 可 以 在 1 秒 内 编译 完 。 在 现代 硬件 上 ， 编 译 整 
个 Go 语言 的 源码 树 只 需要 20 秒 。 


因为 没有 从 编译 代码 到 执行 代码 的 中 间 过 程 ， 用 动态 语言 编写 应 用 
程序 可 以 快速 看 到 输出 。 代 价 是 ， 动 态 语言 不 提供 静态 语言 提供 的 类 型 
安全 特性 ， 不 得 不 经 常用 大 量 的 测试 套件 来 避免 在 运行 的 时 候 出 现 类 型 
错误 这 类 bug。 














想象 一 下 ， 使 用 类 似 JavaScript 这 种 动态 语言 开发 一 个 大 型 应 用 程 
序 ， 有 一 个 函数 期 望 接收 一 个 叫 作 ID 的 字段 。 这 个 参数 应 该 是 整数 ， 
是 字符 串 ， 还 是 一 个 UUID? 要 想 知 道 答案 ， 只 能 去 看 源 代 码 。 可 以 党 
试 使 用 一 个 数字 或 者 字符 串 来 执行 这 个 函数 ， 看 看 会 发 生 什 么 。 在 Go 
人 
4 错误 。 


1.1.2 并 发 


作为 程序 员 ， 要 开发 出 能 充分 利用 硬件 资源 的 应 用 程序 是 一 件 很 难 
的 事情 。 现 代 计 算 机 都 拥有 多 个 核 ， 但 是 大 部 分 编程 语言 都 没有 有 效 的 
工具 让 程序 可 以 轻易 利用 这 些 资 源 。 这 些 语言 需要 写 大 量 的 线程 同步 代 
码 来 利用 多 个 核 ， 很 容易 导致 错误 。 


Go 语言 对 并 发 的 文 持 是 这 门 语言 最 重要 的 特性 之 一 。goroutine 很 像 
线程 ， 但 是 它 占 用 的 内 存 远 少 于 线程 ， 使 用 它 需 要 的 代码 更 少 。 通 道 
(channel) 是 一 种 内 置 的 数据 结构 ， 可 以 让 用 户 在 不 同 的 goroutine 之 间 
同步 发 送 具 有 类 型 的 消息 。 这 让 编程 模型 更 倾 癌 于 在 goroutine 之 间 发 送 
消息 ， 而 不 是 让 多 个 goroutine 和 争夺 同一 个 数据 的 使 用 权 。 让 我 们 看 看 这 
些 特性 的 细节 。 











1. goroutine 


goroutine 是 可 以 与 其 他 goroutine 并 行 执行 的 函数 ， 同 时 也 会 与 主 程 
序 〈 程 序 的 入 口 ) 并 行 执 行 。 在 其 他 编程 语言 中 ， 你 需要 用 线程 来 完成 
同样 的 事情 ， 而 在 Go 语言 中 会 使 用 同一 个 线程 来 执行 多 个 goroutine。 例 
如 ， 用 户 在 写 一 个 Web 服务 器 ， 和 希望 同时 处 理 不 同 的 web 请 求 ， 如 果 使 
用 C 或 者 Java， 不 得 不 写 大 量 的 额外 代码 来 使 用 线程 。 在 Go 语言 中 ， 
net/http 库 直接 使 用 了 内 置 的 goroutine。 每 个 接收 到 的 请 求 都 自动 在 其 自 
己 的 goroutine 里 处 理 。goroutine 使 用 的 内 存 比 线程 更 少 ，Go 语 言 运行 时 
会 日 动 在 配置 的 一 组 逻辑 处 理 器 上 调度 执行 goroutine。 每 个 逻辑 处 理 器 
绑 定 到 一 个 操作 系统 线程 上 〈 见 图 1-2) 。 这 让 用 户 的 应 用 程序 执行 效 
率 更 高 ， 而 开发 工作 量 显著 减少 。 








goroutine goroutine goroutine goroutine goroutine goroutine 


goroutine | | goroutine | | goroutine 


线程 线程 线程 


图 1-2 ”在 单一 系统 线程 上 执行 多 个 goroutine 


如 果 想 在 执行 一 段 代码 的 同时 ， 并 行 去 做 男 外 一 些 事情 ，goroutine 
是 很 好 的 选择 。 下 面 是 一 个 简单 的 例子 : 








func log(msg string) { 
..， 这 里 是 一 些 记录 日 志 的 代码 























} 


// 代码 里 有 些 地 方 检测 到 了 错误 
go log(" 发 生 了 可 怕 的 事情 ") 


























关键 字 go 是 唯一 需要 去 编写 的 代码 ， 调 度 1og 函数 作为 独立 的 
goroutine 去 运行 ， 以 便 与 其 他 goroutine 并 行 执 行 。 这 意味 着 应 用 程序 的 
其 余部 分 会 与 记录 日 志 并 行 执 行 ， 通 常 这 种 并 行 能 让 最 终 用 户 觉 得 性 能 
更 好 。 就 像 之 前 说 的 ，goroutine 占 用 的 资源 更 少 ， 所 以 常常 能 启动 成 干 
上 万 个 goroutine。 我 们 会 在 第 6 章 更 加 深入 地 探讨 goroutine 和 并 发 。 








2. 通道 


通道 是 一 种 数据 结构 ， 可 以 让 goroutine 之 间 进 行 安 全 的 数据 通信 。 
通道 可 以 帮 用 户 避 人 免 其 他 语言 里 常见 的 共享 内 存 访问 的 问题 。 


并 发 的 最 难 的 部 分 号 是 要 确保 其 他 并 友 运 行 的 进程 、 线 程 或 
goroutine 不 会 意外 修改 用 户 的 数据 。 当 不 同 的 线程 在 没有 同步 保护 的 情 
况 下 修改 同一 个 数据 时 ， 总 会 发 生 灾难 。 在 其 他 语言 中 ， 如 宋 使 用 全 局 
变量 或 者 共 孕 内存， 必须 使 用 复杂 的 锁 规则 来 防止 对 同一 个 变量 的 不 同 


步 修改 。 








为 了 解决 这 个 问题 ， 通 道 提供 了 一 种 新 模式 ， 从 而 保证 并 发 修改 时 
的 数据 安全 。 通 道 这 一 模式 保证 同一 时 刻 只 会 有 一 个 goroutine 修 改 数 
据 。 通 道 用 于 在 几 个 运行 的 goroutine 之 间 发 送 数据 。 在 图 1-3 中 可 以 看 到 
数据 是 如 何 流动 的 示例 。 想 象 一 个 应 用 程序 ， 有 多 个 进程 需要 顺序 读 取 
， 使 用 goroutine 和 通道 ， 可 以 为 这 个 过 程 建立 安全 的 
芮 型 。 





goroutine 


goroutine 
goroutine 
通道 通道 


图 1-3 ”使 用 通道 在 goroutine 之 间 安 全 地 发 送 数据 


图 1-3 中 有 3 个 goroutine， 还 有 2 个 不 带 缓 存 的 通道 。 第 一 个 goroutine 
通过 通道 把 数据 传 给 已 经 在 等 待 的 第 二 个 goroutine。 在 两 个 goroutine 间 
传输 数据 是 同步 的 ， 一 旦 传输 完成 ， 两 个 goroutine 都 会 知道 数据 已 经 完 
成 传输 。 当 第 二 个 goroutine 利 用 这 个 数据 完成 其 任务 后 ， 将 这 个 数据 传 
给 第 三 个 正在 等 竺 的 goroutine。 这 次 传输 依旧 是 同步 的 ， 两 个 goroutine 
都 会 确认 数据 传输 完成 。 这 种 在 goroutine 之 间 安 全 传输 数据 的 方法 不 需 
要 任何 锁 或 者 同步 机 制 。 


需要 强调 的 是 ， 通 道 并 不 提供 路 goroutine 的 数据 访问 保护 机 制 。 如 
果 通 过 通道 传输 数据 的 一 份 天 本 ， 那 么 每 个 goroutine 都 持 有 一 份 副本 ， 
各 自 对 自己 的 副本 做 修改 是 安全 的 。 当 传输 的 是 指向 数据 的 指针 时 ， 如 
和 是 由 不 同 的 goroutine 完 成 的 ， 每 个 goroutine 依 旧 需 要 额外 的 同 
步 动 作 。 


1.1.3 Go 语言 的 类 型 系统 


Go 语言 提供 了 灵活 的 、 无 继承 的 类 型 系统 ， 无 需 降 低 运行 性 能 束 
能 最 大 程度 上 复 用 代码 。 这 个 类 型 系统 依然 文 持 面 问 对 象 开 发 ， 但 避免 








了 传统 面 癌 对 象 的 问题 。 如 果 你 曾经 在 复杂 的 Java 和 C++ 程序 上 人 花 数 周 
时 间 考 虑 如 何 抽象 类 和 接口 ， 你 就 能 意识 到 Go 语言 的 类 型 系统 有 多 人 么 
简单 。Go 开发 者 使 用 组 合 (composition) 设计 模式 ， 只 需 简 单 地 将 一 
个 类 型 坐 入 到 另 一 个 类 型 ， 惑 能 复 用 所 有 的 功能 。 其 他 语言 也 能 使 用 组 
合 ， 但 是 不 得 不 和 继承 绑 在 一 起 使 用 ， 结 果 使 整个 用 法 非常 复杂 ， 很 难 
使 用 。 在 Go 语言 中 ， 一 个 类 型 由 其 他 更 微小 的 类 型 组 合 而 成 ， 避 人 免 了 
传统 的 基于 继承 的 模型 。 


男 外 ，Go 语 言 还 具有 独特 的 接口 实现 机 制 ， 人 允许 用 户 对 行为 进行 
建 模 ， 而 不 是 对 类 型 进行 建 模 。 在 Go 语言 中 ， 不 需要 声明 某 个 类 型 实 
现 了 某 个 接口 ， 编 译 需 会 判断 一 个 类 型 的 实例 是 人 否 符 合 正在 使 用 的 接 
口 。Go 标 准 库 里 的 很 多 接口 都 非常 简单 ， 只 开放 几 个 函数 。 从 实践 上 
讲 ， 尤 其 对 那些 使 用 类 似 Java 的 面向 对 象 语言 的 人 来 说 ， 需 要 一 些 时 间 
才能 习惯 这 个 特性 。 


1. 类 型 简单 


Go 语言 不 仅 有 类 似 int 和 string 这 样 的 内 置 类 型 ， 还 支持 用 户 定 
义 的 类 型 。 在 Go 语言 中 ， 用 户 定义 的 类 型 通常 包含 一 组 带 类 型 的 字 
段 ， 用 于 存储 数据 。Go 语 言 的 用 户 定义 的 类 型 看 起 来 和 C 语 言 的 结构 很 
像 ， 用 起 来 也 很 相似 。 不 过 Go 语言 的 类 型 可 以 声明 操作 该 类 型 数据 的 
方法 。 传 统 语言 使 用 继承 来 扩展 结构 Client 继 承 自 User，User 继 承 
自 Entity，Go 语 言 与 此 不 同 ，Go 开 发 者 构建 更 小 的 类 型 一 Customer 和 
Admin， 然 后 把 这 些小 类 型 组 合成 更 大 的 类 型 。 图 1-4 展 示 了 继承 和 组 合 
之 间 的 不 同 。 




















图 1-4 ”继承 和 组 合 的 对 比 
2. Go 接口 对 一 组 行为 建 模 


接口 用 于 描述 类 型 的 行为 。 如 采 一 个 类 型 的 实例 实现 了 一 个 接口 ， 
意味 着 这 个 实例 可 以 执行 一 组 特定 的 行为 。 你 甚至 不 需要 去 声明 这 个 实 
例 实现 茶 个 接口 ， 只 需要 实现 这 组 行为 就 好 。 其 他 的 语言 把 这 个 特性 叫 
作 鸭 子 类 型 如 果 它 叫 起 来 像 鸭子 ， 那 它 就 可 能 是 只 鸭子 。Go 语 言 
的 接口 也 是 这 么 做 的 。 在 Go 语言 中 ， 如 末 一 个 类 型 实现 了 一 个 接口 的 
所 有 方法 ， 那 么 这 个 类 型 的 实例 就 可 以 存储 在 这 个 接口 类 型 的 实例 中 ， 
不 需要 额外 声明 。 


在 类 似 Java 这 种 严格 的 面 癌 对 象 语 言 中 ， 所 有 的 设计 都 围绕 接口 展 
开 。 在 编码 前 ， 用 户 经 常 不 得 不 思考 一 个 庞大 的 继承 链 。 下 面 是 一 个 
Java 接 口 的 例子 : 























interface User { 
public void login(); 
public void logout(); 


} 





在 Java 中 要 实现 这 个 接口 ， 要 求 用 户 的 类 必须 满足 User 接口 里 的 
所 有 约束 ， 并 且 显 式 声明 这 个 类 实现 了 这 个 接口 。 而 Go 语言 的 接口 一 
般 只 会 描述 一 个 单一 的 动作 。 在 Go 语言 中 ， 最 常 使 用 的 接口 之 一 
是 io.Reader 。 这 个 接口 提供 了 一 个 简单 的 方法 ， 用 来 声明 一 个 类 型 有 
数据 可 以 读 取 。 标 准 库 内 的 其 他 函数 都 能 理解 这 个 接口 。 这 个 接口 的 定 





义 如 下 : 


type Reader interface { 
Read(p []byte) (n int, err error) 
} 


为 了 实现 io.Reader 这 个 接口 ， 你 只 需要 实现 一 个 Read 方法 ， 这 
个 方法 接受 一 个 byte 切片 ， 返 回 一 个 整数 和 可 能 出 现 的 错误 。 


这 和 传统 的 面 问 对象 编程 语言 的 接口 系统 有 本 质 的 区 别 。Go 语 言 
的 接口 更 小 ， 只 倾 同 于 定义 一 个 单一 的 动作 。 实 际 使 用 中 ， 这 更 有 利于 
使 用 组 合 来 复 用 代码 。 用 户 几 乎 可 以 给 所 有 包含 数据 的 类 型 实现 
io.Reader 接口 ， 然 后 把 这 个 类 型 的 实例 传 给 任意 一 个 知道 如 何 读 取 
io.Reader 的 Go 函数 。 


Go 语言 的 整个 网 络 库 都 使 用 了 io .Reader 接口 ， 这 样 可 以 将 程序 
的 功能 和 不 同 网 络 的 实现 分 离 。 这 样 的 接口 用 起 来 有 趣 、 优 雅 且 自由 。 
文件 、 组 冲 区 、 套 接 字 以 及 其 他 的 数据 源 都 实现 了 io.Reader 接口 。 使 
用 同一 个 接口 ， 可 以 高 效 地 操作 数据 ， 而 不 用 考虑 到 底数 据 来 自 哪里 。 


1.1.4 内 存 管理 


不 当 的 内 存 管理 会 导致 程序 骨 尝 或 者 内 存 泄漏 ， 甚 至 让 整个 操作 系 
统 朋 沉 。Go 语 言 拥 有 现代 化 的 垃圾 回收 机 制 ， 能 帮 你 解决 这 个 难题 。 
在 其 他 系统 语言 《如 C 或 者 C++) 中 ， 使 用 内 存 前 要 先 分 配 这 段 内 存 ， 
而 且 使 用 完毕 后 要 将 其 释放 挥 。 哪 怕 只 做 错 了 一 件 事 ， 都 可 能 导致 程序 
月 温 或 者 内 存 泄 漏 。 可 惜 ， 退 踪 内 存 是 人 否 还 被 使 用 本 身 束 是 十 分 艰难 的 
事情 ， 而 要 想 文 持 多 线程 和 高 并 发 ， 更 是 让 这 件 事 难 上 加 难 。 虽 然 Go 
语言 的 垃圾 回收 会 有 一 些 额外 的 开销 ， 但 是 编程 时 ， 能 显 车 降低 开发 难 
度 。Go 语 言 把 无 趣 的 内 存 管 理 交 给 专业 的 编译 局 去 做 ， 而 让 程序 员 专 
注 于 更 有 趣 的 事情 。 














1.2 ”你 好 ，Go 


感受 一 门 语言 最 简单 的 方法 就 是 实践 。 让 我 们 看 看 用 Go 语言 如 何 
编写 经 典 的 Hello World! 应 用 程序 : 


package main 





Go 程序 都 组 织 成 包 。 














import "fmt" import 语 句 用 于 导入 外 部 代码 。 标 准 库 中 的 fmt 包 用 于 格式 化 并 输 
出 数据 。 
func main() { e 像 C 语 言 一 样 ，main 函 数 是 程序 执行 的 入 口 。 





fmt.Println("Hello world!") 





运行 这 个 示例 程序 后 会 在 屏幕 上 町 出 我 们 熟悉 的 一 句 话 。 但 是 怎么 
运行 呢 人 言 ， 在 浏览 器 中 就 可 以 使 用 几乎 所 有 
Go 语言 的 功能 。 


介绍 Go Playground 


Go Playground 人 允许 在 浏览 器 里 编辑 并 运行 Go 语言 代码 。 在 浏览 
/play.golang.org 。 浏 览 器 里 展示 的 代码 是 可 编辑 的 UL 
。 点 击 Run， 看 看 会 发 生 什 么 。 








BO Go Playground 要 
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Go Playground Run Format Share About 


package main 


import "fmt" 


func main() { 
fmt.Println("Hello, playground") 
1 








图 1-5 Go Playground 


可 以 把 输出 的 问候 文字 改 成 别 的 语言 。 试 看 改 动 fmt.Println() 
里 面 的 文字 ， 然 后 再 次 点 击 Run。 


分 享 Go 代码 ”Go 开发 者 使 用 Playground 分 享 他 们 的 想法 ， 测 
试 理论 ， 或 者 调试 代码 。 你 也 可 以 这 么 做 。 每 次 使 用 Playground 创 | 
建 一 个 新 程序 之 后 ， 可 以 点 击 Share 得 到 一 个 用 于 分 享 的 网 址 。 任 
何人 都 能 打开 这 个 链接 。 试 试 http://play.golang.org/p/EWIXicJdmz 








要 给 想 要 学 习 写 东西 或 者 寻求 帮助 的 同事 或 者 朋友 演示 某 个 想法 
时 ，Go Playground 是 非常 好 的 方式 。 在 Go 语言 的 IRC 频 道 、Slack 群 组 、 
邮件 列表 和 Go 开发 者 发 送 的 无 数 邮 件 里 ， 用 户 都 能 看 到 创建 、 修 改 和 
分 享 Go Playground 上 的 程序 。 





1.3 ”小结 


。 Go 语言 是 现代 的 、 快 速 的 ， 带 有 一 个 强大 的 标准 库 。 
。 Go 语言 内 置 对 并 发 的 支持 。 
。 Go 语言 使 用 接口 作为 代码 复 用 的 基础 模块 。 





第 2 革 ”快速 开始 一 个 Go 程序 
本 章 主要 内 容 


学 习 如 何 写 一 个 复杂 的 Go 程序 
声明 类 型 、 变 量 、 函 数 和 方法 
启动 并 同步 操作 goroutine 
使 用 接口 写 通 用 的 代码 

处 理 程序 逻辑 和 错误 


为 了 能 更 高 效 地 使 用 语言 进行 编码 ，Go 语 言 有 自己 的 哲学 和 编程 
习惯 。Go 语 言 的 设计 者 们 从 编程 效率 出 发 设计 了 这 门 语言 ， 但 又 不 会 
丢掉 访问 底层 程序 结构 的 能 力 。 设 计 者 们 通过 一 组 最 少 的 关键 字 、 内 置 
的 方法 和 语法 ， 最 终 平 衡 了 这 两 方面 。Go 语 言 也 提供 了 完善 的 标准 
人 
心 奋 s 


让 我 们 通过 一 个 完整 的 Go 语言 程序 ， 来 看 看 Go 语言 是 如 何 实现 这 
些 功能 的 。 这 个 程序 实现 的 功能 很 常见 ， 能 在 很 多 现在 开发 的 Go 程序 
里 发 现 类 似 的 功能 。 这 个 程序 从 不 同 的 数据 源 拉 取 数 据 ， 将 数据 内 容 与 
一 组 搜索 项 做 对 比 ， 然 后 将 匹配 的 内 容 显 示 在 终端 窗口 。 这 个 程序 会 读 
取 文 本 文件 ， 进 行 网 络 调用 ， 解 码 XML 和 JSON 成 为 结构 化 类 型 数据 ， 
并 且 利 用 Go 语言 的 并 发 机 制 保证 这 些 操作 的 速度 。 


读者 可 以 下 载 本 间 的 代码 ， 用 自己 喜欢 的 编辑 如 阅读 。 代 码 存 放 在 
这 个 代码 库 ; 














https://github.com/goinaction/code/tree/master/chapter2/sample 








没 必 要 第 一 次 就 恋 公 本章 的 所 有 扩容 ， 可 以 多 读 两 通 。 在 学 习 时 ， 
虽然 很 多 现代 语言 的 概念 可 以 对 应 到 Go 语言 中 ，Go 语 言 还 是 有 一 些 独 


特 的 特性 和 风格 。 如 果 放 下 已 经 熟悉 的 编程 语言 ， 用 一 种 全 新 的 眼光 来 
审视 Go 语言， 你 会 更 容易 理解 并 接受 Go 语言 的 特性 ， 发 现 Go 语 言 的 优 
2.1 程序 架构 


在 深入 代码 之 前 ， 让 我 们 看 一 下 程序 的 架构 (如 图 2-1 所 示 ) ， 看 
看 如 何在 所 有 不 同 的 数据 源 中 搜索 数据 。 





主 goroutine 





| 获取 数据 | 
执行 搜索 


跟踪 结果 


| are | 


me goroutine 


一 组 等 待 搜 
索 的 数据 源 


执行 搜索 的 goroutine 


使 用 接口 报告 任 
Ele 

等 待 所 

有 结果 


图 2-1 程序 架构 流程 图 











这 个 程序 分 成 多 个 不 同步 又 ， 在 多 个 不 同 的 goroutine 里 运行 。 我 们 





会 根据 流程 展示 代码 ， 从 主 goroutine 开 始 ， 一 直到 执行 搜索 的 goroutine 
和 跟踪 结果 的 goroutine， 最 后 回 到 主 goroutine。 首 先 来 看 一 下 整个 项 目 
的 结构 ， 如 代码 清单 2-1 所 示 。 








代码 清单 2-1 ”应 用 程序 的 项 目 结构 








cd $GOPATH/src/github.com/goinaction/code/chapter2 


- sample 

- data 
data.json 

- matchers 
rss.go 

- search 
default.go 
feed.go 
match.go 
search.go 

main.go 





-- 包含 一 组 数据 源 
-- 搜索 rss 源 的 匹配 器 


-- 搜索 数据 用 的 默认 匹配 器 
-- 用 于 读 取 json 数 据 文件 
-- 用 于 文 持 不 同 匹 配器 的 接口 
-- 执行 搜索 的 主 控制 逻辑 

-- 程序 的 入 口 












































| | 


这 个 应 用 的 代码 使 用 了 4 个 文件 夹 ， 按 字母 顺序 列 出 。 文 件 夹 data 中 
有 一 个 JSON 文 档 ， 其 内 容 是 程序 要 拉 取 和 处 理 的 数据 源 。 文 件 夹 
matchers 中 包含 程序 里 用 于 支持 搜索 不 同 数 据 源 的 代码 。 目 前 程序 只 完 
成 了 支持 处 理 RSS 类 型 的 数据 源 的 匹配 器 。 文 件 夹 search 中 包含 使 用 不 
同 匹 配器 进行 搜索 的 业务 逻辑 。 最 后 ， 父 级 文件 夹 sample 中 有 个 main.go 
文件 ， 这 是 整个 程序 的 入 口 。 


现在 了 解 了 如 何 组 织 程序 的 代码 ， 可 以 继续 探索 并 了 解 程序 是 如 何 
工作 的 。 让 我 们 从 程序 的 入 口 开始 。 











2.2 main 包 


程序 的 主 入 口 可 以 在 main.go 文 件 里 找到 ， 如 代码 清单 2-2 所 示 。 虽 
然 这 个 文件 只 有 21 行 代码 ， 依 然 有 儿 扣 需要 注意 。 








代码 清单 2-2 main.go 





package main 


import ( 
"log" 
"os" 


_ "github.com/goinaction/code/chapter2/sample/matchers" 
"github.com/goinaction/code/chapter2/sample/search" 


) 


// init 在 main 之 前 调用 
func init() 
// 将 日 志 输 出 到 标准 输出 
log.SetOutput(os.Stdout) 


























} 
// main 是 整个 程序 的 入 口 


func main() { 
// 使 用 特定 的 项 做 搜索 


search.Run("president") 

















每 个 可 执行 的 Go 程序 都 有 两 个 明显 的 特征 。 一 个 特征 是 第 18 行 声 
明 的 名 为 main 的 函数 。 构 建 程序 在 构建 可 执行 文件 时 ， 需 要 找到 这 个 
已 经 声明 的 main 函数 ， 把 它 作 为 程序 的 入 口 。 第 二 个 特征 是 程序 的 第 
01 行 的 包 名 main ， 如 代码 清单 2-3 所 示 。 











代码 清单 2-3 main.go: 第 01 行 


61 package main 


可 以 看 到 ，main 函数 保存 在 名 为 main 的 包 里 。 如 果 main 消 数 不 
在 main 包 里 ， 构 建 工 具 就 不 会 生成 可 执行 的 文件 。 


Go 语言 的 每 个 代码 文件 都 属于 一 个 包 ，main.go 也 不 例外 。 包 这 个 
特性 对 于 Go 语言 来 说 很 重要 ， 我 们 会 在 第 3 章 中 接触 到 更 多 细节 。 现 
在 ， 只 要 简单 了 解 以 下 内 容 : 一 个 包 定 义 一 组 编译 过 的 代码 ， 包 的 名 字 
类 似 命名 空间 ， 可 以 用 来 间接 访问 包 内 声明 的 标识 符 。 这 个 特性 可 以 把 
不 同 包 中 定义 的 同名 标识 符 区 别 开 。 


现在 ， 把 注意 力 转 到 main.go 的 第 03 行 到 第 09 行 ， 如 代码 清单 2-4 所 
示 ， 这 里 声明 了 所 有 的 导入 项 。 























代码 清单 2-4 main.go: 第 03 行 到 第 09 行 








863 import ( 
"log" 
"os" 


_ "github.com/goinaction/code/chapter2/sample/matchers" 
"github.com/goinaction/code/chapter2/sample/search" 





顾名思义 ， 关 键 字 import 就 是 导入 一 段 代 码 ， 让 用 户 可 以 访问 其 
中 的 标识 符 ， 如 类 型 、 函 数 、 常 量 和 接口 。 在 这 个 例子 中 ， 由 于 第 08 行 
的 导入 ，main.go 里 的 代码 就 可 以 引用 search 包 里 的 Run 函数 。 程 序 的 
第 04 行 和 第 05 行 导入 标准 库 里 的 log 和 os 包 。 


所 有 处 于 同一 个 文件 夹 里 的 代码 文件 ， 必 须 使 用 同一 个 包 名 。 按 照 
惯例 ， 包 和 文件 夹 同名 。 就 像 之 前 说 的 ， 一 个 包 定 义 一 组 编译 后 的 代 











码 ， 每 段 代 码 都 描述 包 的 一 部 分 。 如 宁 回 头 去 看 看 代码 清单 2-1， 可 以 
看 看 第 08 行 的 导入 是 如 何 指定 那个 项 目 里 名 叫 search 的 文件 夹 的 。 


读者 可 能 注意 到 第 07 行 导入 matchers 包 的 时 候 ， 导 入 的 路 径 前 面 
有 一 个 下 划 线 ， 如 代码 清单 2-5 所 示 。 























代码 清单 2-5 main.go: 第 07 行 











07 _ "github.com/goinaction/code/chapter2/sample/matchers" 


这 个 技术 是 为 了 让 Go 语言 对 包 做 初始 化 操作 ， 但 是 并 不 使 用 包 里 
的 标识 符 。 为 了 让 程序 的 可 读 性 更 强 ，Go 编译 器 不 允许 声明 导入 某 个 
包 却 不 使 用 。 下 划 线 让 编译 器 接受 这 类 导入 ， 并 且 调 用 对 应 包 内 的 所 有 
代码 文件 里 定义 的 init 函数 。 对 这 个 程序 来 说 ， 这 样 做 的 目的 是 调 
用 matchers 包 中 的 rss.go 代 码 文件 里 的 init 函数 ， 注 册 RSS 匹 配器 ， 
以 便 后 用 。 我 们 后 面 会 展示 具体 的 工作 方式 。 


代码 文件 main.go 里 也 有 一 个 init 函数 ， 在 第 12 行 到 第 15 行 中 声 
明 ， 如 代码 清单 2-6 所 示 。 











代码 清单 2-6 main.go: 第 11 行 到 第 15 行 























11 // init 在 main 之 前 调用 
12 func init() { 
// 将 日 志 输 出 到 标准 输出 











log.SetOutput(os.Stdout) 





程序 中 每 个 代码 文件 里 的 init 函数 都 会 在 main 函数 执行 前 调用 。 
这 个 init 函数 将 标准 库 里 日 志 类 的 输出 ， 从 默认 的 标准 错误 (stderr 
) ， 设 置 为 标准 输出 (stdout ) 设备 。 在 第 7 章 ， 我 们 会 进一步 讨论 
log 包 和 标准 库 里 其 他 重要 的 包 。 


二 让 我 们 看 看 main 函数 第 20 行 那 条 语句 的 作用 ， 如 代码 清单 
2-7 上 未 。 





代码 清单 2-7 main.go: 第 19 行 到 第 20 行 











// 使 用 特定 的 项 做 搜索 


search.Run("president") 





可 以 看 到 ， 这 一 行 调用 了 search 包 里 的 Run 函数 。 这 个 函数 包含 
程序 的 核心 业务 逻辑 ， 需 要 传 入 一 个 字符 串 作为 搜索 项 。 一 旦 Run 函数 
退出 ， 程 序 就 会 终止 。 


现在 ， 让 我 们 看 看 search 包 里 的 代码 。 


2.3 search 包 


这 个 程序 使 用 的 框 絮 和 业务 过 辑 者 在 search 包 里 。 这 个 包 由 4 个 不 
同 的 代码 文件 组 成 ， 每 个 文件 对 应 一 个 独立 的 职责 。 我 们 会 逐步 分 析 这 
个 程序 的 逻辑 ， 到 时 再 说 明 各 个 代码 文件 的 作用 。 


由 于 整个 程序 都 围绕 匹配 器 来 运作 ， 我 们 先 简单 介绍 一 下 什么 是 匹 
配器 。 这 个 程序 里 的 匹配 器 ， 是 指 包含 特定 信息 、 用 于 处 理 某 类 数据 源 
的 实例 。 在 这 个 示例 程序 中 有 两 个 匹配 器 。 框架 本 身 实现 了 一 个 无 法 获 
取 任 何 信息 的 默认 匹配 器 ， 而 在 matchers 包 里 实现 了 RSS 匹 配器 。RSS 
匹配 器 知道 如 何 获取 、 读 入 并 查找 RSS 数 据 源 。 随 后 我 们 会 扩展 这 个 程 
序 ， 加 入 能 读 取 JSON 文 档 或 CSV 文 件 的 匹配 器 。 我 们 后 面 会 再 讨论 如 
何 实现 匹配 器 。 











2.3.1 search.go 


代码 清单 2-8 中 展示 的 是 search.go 代 码 文 件 的 前 9 行 代码 。 之 前 提 到 
的 Run 函数 束 在 这 个 文件 里 。 


代码 清单 2-8 ”search/search.go: 第 01 行 到 第 09 行 











61 package search 


62 

863 import ( 
84 "log 
65 "sync 
66 ) 

67 


868 // 注册 用 于 搜索 的 匹配 器 的 映射 


69 var matchers = make(map[string]Matcher) 


可 以 看 到 ， 每 个 代码 文件 都 以 package 关键 字 开 头 ， 随 后 跟着 包 的 
名 字 。 文 件 夹 search 下 的 每 个 代码 文件 都 使 用 search 作为 包 名 。 第 03 
行 到 第 06 行 代码 导入 标准 库 的 log 和 sync 包 。 


与 第 三 方 包 不 同 ， 从 标准 库 中 导入 代码 时 ， 只 需要 给 出 要 导入 的 包 
名 。 编 译 器 查找 包 的 时 候 ， 总 是 会 到 GOROOT 和 GOPATH 环境 变量 (如 代 
码 清单 2-9 所 示 ) 引用 的 位 置 去 查找 。 




















代码 清单 2-9 GOROOT 和 GOPATH 环境 变量 














GOROOT="/Users/me/go" 


GOPATH=" /Users/me/spaces/go/projects" 





log 包 提 供 打 印 日 志 信 息 到 标准 输出 (stdout ) 、 标 准 错误 
(stderr ) 或 者 自 定义 设备 的 功能 。sync 包 提 供 同 步 goroutine 的 功 
能 。 这 个 示例 程序 需要 用 到 同步 功能 。 第 09 行 是 全 书 第 一 次 声明 一 个 变 
量 ， 如 代码 清单 2-10 所 示 。 





代码 清单 2-10 ”search/search.go: 第 08 行 到 第 09 行 


68 // 注册 用 于 搜索 的 匹配 器 的 映射 
69 var matchers = make(map[string]Matcher) 


这 个 变量 没有 定义 在 任何 函数 作用 域内 ， 所 以 会 被 当成 包 级 变量 。 
这 个 变量 使 用 关键 字 var 声明 ， 而 且 声 明 为 Matcher 类 型 的 映射 (map 
) ， 这 个 映射 以 string 类 型 值 作为 键 ，Matcher 类 型 值 作为 映射 后 的 
值 。Matcher 类 型 在 代码 文件 matcher.go 中 声明 ， 后 面 再 讲 这 个 类 型 的 
用 途 。 这 个 变量 声明 还 有 一 个 地 方 要 强调 一 下 : 变量 名 matchers 是 以 
小 号 字母 开 头 的 。 


在 Go 语言 里 ， 标 识 符 要 么 从 包 里 公开 ， 要 么 不 从 包 里 公开 。 当 代 
码 导 入 了 一 个 包 时 ， 程 序 可 以 直接 访问 这 个 包 中 任意 一 个 公开 的 标识 
符 。 这 些 标识 竺 以 大 写字 母 开头 。 以 小 写字 母 开头 的 标识 符 是 不 公开 
的 ， 不 能 被 其 他 包 中 的 代码 直接 访问 。 但 是 ， 其 他 包 可 以 间接 访问 不 公 























开 的 标识 符 。 例 如 ， 一 个 函数 可 以 返回 一 个 未 公开 关 型 的 什 ， 那 么 这 个 
人 哪怕 调用 者 不 是 在 这 个 包 里 声明 的 ， 都 可 以 访问 这 
Es 


这 行 变量 声明 还 使 用 赋值 运算 符 和 特殊 的 内 置 函 数 make 初始 化 了 
变量 ， 如 代码 清单 2 11 所 示 。 














代码 清单 2-11 构建 一 个 映射 


make(map[string]Matcher) 


map 是 Go 语言 里 的 一 个 引用 类 型 ， 需 要 使 用 make 来 构造 。 如 果 不 
先 构造 map 并 将 构造 后 的 值 赋值 给 变量 ， 会 在 试图 使 用 这 个 map 变量 时 
收 到 出 错 信息 。 这 是 因为 map 变量 默认 的 零 值 是 nil 。 在 第 4 章 我 们 会 
进一步 了 解 关 于 映射 的 细节 。 


在 Go 语言 中 ， 所 有 变量 都 被 初始 化 为 其 零 值 。 对 于 数值 类 型 ， 零 
值 是 6 ;， 对 于 字符 串 类 型 ， 零 值 是 空 字符 串 ;， 对 于 布尔 类 型 ， 零 值 
是 false ; 对 于 指针 ， 零 值 是 nil 。 对 于 引用 类 型 来 说 ， 所 引用 的 底层 
数据 结构 会 被 初始 化 为 对 应 的 零 值 。 但 是 被 声明 为 其 零 值 的 引用 类 型 的 
变量 ， 会 返回 nil 作为 其 值 。 


现在 ， 让 我 们 看 看 之 前 在 main 函数 中 调用 的 Run 函数 的 内 容 ， 如 
代码 清单 2-12 所 示 。 


























代码 清单 2-12 ”search/search.go: 第 11 行 到 第 57 行 

















11 // Run 执 行 搜 索 逻 辑 











12 func Run(searchTerm string) { 


13 // 获取 需要 搜索 的 数据 源 列 表 

















14 feeds, err := RetrieveFeeds() 

15 if err != nil { 

16 log.Fatal(err) 

17 

18 

19 // 创建 一 个 无 缓冲 的 通道 ， 接 收 匹配 后 的 结果 
20 results := make(chan *Result) 

21 














22 // 构造 一 个 waitGroup， 以 便 处 理 所 有 的 数据 源 


23 var waitGroup sync.WaitGroup 
















































































25 // 设置 需要 等 待 处 理 

26 // 每 个 数据 源 的 goroutine 的 数量 

27 waitGroup .Add(len(feeds) ) 

28 

29 // 为 每 个 数据 源 启动 一 个 goroutine 来 查找 结果 
36 for , feed := range feeds { 

31 // 获取 一 个 匹配 器 用 于 查找 

32 matcher, exists := matchers[feed.Type] 
33 if lexists { 

34 matcher = matchers["default"] 

35 } 

36 

37 // 启动 一 个 goroutine 来 执行 搜索 

38 go func(matcher Matcher, feed *Feed) { 
39 Match(matcher, feed, searchTerm, results) 
40 waitGroup .Done() 

41 }(matcher, feed) 

42 } 

43 

44 // 局 动 一 个 goroutine 来 监控 是 否 所 有 的 工作 都 做 完了 
45 go func() { 

46 // 等 候 所 有 任务 完成 

47 waitGroup .Wait() 

48 

49 // 用 关闭 通道 的 方式 ， 通 知 Display 函 数 

56 // 可 以 退出 程序 了 

51 close(results) 

52 }() 

53 











54 // 启动 函数 ， 显示 返回 的 结果 ， 并 且 
55 // 在 最 后 一 个 结果 显示 完 后 返回 
56 Display(results) 




















Run 了 水 数 包括 了 这 个 程序 最 主要 的 控制 逻辑 。 这 上段 代码 很 好 地 展示 
了 如 何 组 织 Go 程 序 的 代码 ， 以 便 正 确 地 并 发 启动 和 同步 goroutine。 先 来 
一 步 一 步 考察 整个 逻辑 ， 再 考察 每 步 实 现代 码 的 细节 。 


先 来 看 看 Run 函数 是 怎么 定义 的 ， 如 代码 清单 2-13 所 示 。 


代码 清单 2-13 ”search/search.go: 第 11 行 到 第 12 行 


11 // Run 执行 搜索 逻辑 

















12 func Run(searchTerm string) { 


Go 语言 使 用 关键 字 func 声明 函数 ， 关 键 字 后 面 紧 跟着 函数 名 、 参 

数 以 及 返回 入 对 于 Run 这 个 函数 来 说 ， 只 有 一 个 参数 ， 人 

型 的 ， 名 叫 searchTerm 。 这 个 参数 是 Run 函数 要 搜索 的 搜索 项 ， 如 果 

Se 函数 《如 代码 清单 2-14 所 示 ) ， 可 以 看 到 如 何 传递 这 站 
过 有 


























代码 清单 2-14 ”main.go: 第 17 行 到 第 21 行 





17 // main 是 整个 程序 的 入 口 
18 func main() { 
19 // 使 用 特定 的 项 做 搜索 











20 search.Run("president") 
21 } 











Run 函数 做 的 第 一 件 事情 就 是 获取 数据 源 feeds 列表 。 这 些 数 据 源 
A 之 后 对 数据 使 用 特定 的 搜索 项 进行 匹配 ， 如 代码 
清单 2-15 所 示 。 





代码 清单 2-15 ”search/search.go: 第 13 行 到 第 17 行 











// 获取 需要 搜索 的 数据 源 列表 
feeds, err := RetrieveFeeds() 
if err != nil { 


log.Fatal(err) 





这 里 有 几 个 值得 注意 的 重要 概念 。 第 14 行 调用 了 search 包 的 
RetrieveFeeds 函数 。 这 个 函数 返回 两 个 值 。 第 一 个 返回 值 是 一 组 
Feed 类 型 的 切片 。 切 片 是 一 种 实现 了 一 个 动态 数组 的 引用 类 型 。 在 Go 
| 以 用 切片 来 操作 一 组 数据 。 第 4 章 会 进一步 深入 了 解 有 关切 片 

细节。 


第 二 个 返回 值 是 一 个 错误 值 。 在 第 15 行 ， 检 查 返 回 的 值 是 不 是 真 的 
是 一 个 本 误 ; 如 果真 的 发 生 错 误 了 ， 就 会 调用 log 包 里 的 Fatal 函 
数 。Fatal 函数 接受 这 个 错误 的 值 ， 并 将 这 个 错误 在 终端 窗口 里 输出 ， 
随后 终止 程序 。 


不 仅仅 是 Go 语言 ， 很 多 语言 都 允许 一 个 函数 返回 多 个 值 。 一 般 会 
像 RetrieveFeeds 函数 这 样 声明 一 个 函数 返回 一 个 值 和 一 个 错误 值 。 
如 果 发 生 了 错误 ， 永 远 不 要 使 用 该 函数 返回 的 另 一 个 值 DO 。 这 时 必须 
忽略 男 一 个 值 ， 否 则 程序 会 产生 更 多 的 错误 ， 甚 至 朋 尝 。 


0 
2-16 所 不 。 








代码 清单 2-16 ”search/search.go: 第 13 行 到 第 14 行 


// 获取 需要 搜索 的 数据 源 列表 


feeds, err := RetrieveFeeds() 








这 里 可 以 看 到 简化 变量 声明 运算 符 〈:= ) 。 这 个 运算 符 用 于 声明 
一 个 变量 ， 同 时 给 这 个 变量 赋予 初始 值 。 编 译 占 使 用 函数 返回 值 的 类 型 
来 确定 每 个 变量 的 类 型 。 简 化 变量 声明 运算 符 只 是 一 种 简化 记 法 ， 让 代 
码 可 读 性 更 高 。 这 个 运算 符 声 明 的 变量 和 其 他 使 用 关键 字 var 声明 的 变 
量 没有 任何 区 别 。 


0 0 进入 到 后 面 的 代码 ， 如 代码 清单 2-17 

















代码 清单 2-17 ”search/search.go: 第 19 行 到 第 20 行 





// 创建 一 个 无 缓冲 的 通道 ， 接 收 匹配 后 的 结果 





results := make(chan *Result) 





在 第 20 行 ， 我 们 使 用 内 置 的 make 函数 创建 了 一 个 无 缓冲 的 通道 。 
我 们 使 用 简化 变量 声明 运算 符 ， 在 调用 make 的 同时 声明 并 初始 化 该 通 
道 变 量 。 根 据 经 验 ， 如 有 条 需要 声明 初始 值 为 零 值 的 变量 ， 应 该 使 用 vanr 
关键 字 声 明 变 量 ， 如 果 提 供 确切 的 非 零 值 初始 化 变量 或 者 使 用 函数 返回 
值 创建 变量 ， 应 该 使 用 简化 变量 声明 运算 符 。 


在 Go 语言 中 ， 通 道 (channel) 和 映射 (map) 与 切片 (slice) 一 
样 ， 也 是 引用 类 型 ， 不 过 通道 本 和 喘 实 现 的 是 一 组 带 类 型 的 值 ， 这 组 值 用 
于 在 goroutine 之 间 传 递 数据 。 通 道内 置 同步 机 制 ， 从 而 保证 通信 安全。 
在 第 6 章 中 ， 我 们 会 介绍 更 多 关于 通道 和 goroutine 的 细节 。 











之 后 两 行 是 为 了 防止 程序 在 全 部 搜索 执行 完 之 前 终止 ， 如 代码 清单 
2-18 所 示 。 





代码 清单 2-18 ”search/search.go: 第 22 行 到 第 27 行 























// 构造 一 个 wait group， 以便 处 理 
var waitGroup sync.WaitGroup 























// 设置 需要 等 待 处 理 
// 每 个 数据 源 的 goroutine 的 数量 
waitGroup .Add(len(feeds) ) 














在 Go 语言 中 ， 如 果 main 函数 返回 ， 整 个 程序 也 就 终止 了 。Go 程 序 
终止 时 ， 还 会 关闭 所 有 之 前 启动 且 还 在 运行 的 goroutine。 写 并 发 程序 的 
时 候 ， 最 佳 做 法 是 ， 在 main 函数 返回 前 ， 清 理 并 终止 所 有 之 前 启动 的 
goroutine。 编 写 启 动 和 终止 时 的 状态 都 很 清晰 的 程序 ， 有 助 减少 bug， 


这 个 程序 使 用 sync 包 的 NaitGroup 跟踪 所 有 启动 的 goroutine。 非 
常 推荐 使 用 NaitGroup 来 跟踪 goroutine 的 工作 是 否 完成 。WaitGroup 
J | 我 们 可 以 利用 它 来 统计 所 有 的 goroutine 是 不 是 都 完 
人 


在 第 23 行 我 们 声明 了 一 个 sync 包 里 的 WaitGroup 类 型 的 变量 。 之 
后 在 第 27 行 ， 我 们 将 WaitGroup 变量 的 值 设 置 为 将 要 局 动 的 goroutine 的 
数量 。 马 上 就 能 看 到 ， 我 们 为 每 个 数据 源 都 局 动 了 一 个 goroutine 来 处 理 
数据 。 每 个 goroutine 完 成 其 工作 后 ， 束 会 递减 WaitGroup 变量 的 计数 
值 ， 当 这 个 值 递 减 到 0 时 ， 我 们 就 知道 所 有 的 工作 都 做 完了 。 


0 动 goroutine 的 代码 ， 如 代码 清单 
2-19 用 未 。 

















代码 清单 2-19 ”search/search.go: 第 29 行 到 第 42 行 














29 // 为 每 个 数据 源 启 动 一 个 goroutine 来 查找 结果 

















36 for , feed := range feeds { 

31 // 获取 一 个 匹配 器 用 于 碍 找 

32 matcher，exists := matchers[feed.Type] 
33 if lexists { 


34 matcher = matchers["default"] 


35 } 





36 

37 // 启动 一 个 goroutine 来 执行 搜索 

38 go func(matcher Matcher, feed *Feed) { 

39 Match(matcher, feed, searchTerm, results) 
40 waitGroup .Done() 

41 }(matcher, feed) 

42 } 





第 30 行 到 第 42 行 迭代 之 前 获得 的 feeds ， 为 每 个 feed 启动 一 个 
goroutine。 我 们 使 用 关键 字 for range 对 feeds 切片 做 和 迭代。 关键 
字 range 可 以 用 于 友 代 数组 、 字 符 率 、 切 片 、 上 映射 和 通道 。 使 用 for 
range 人 迭代 切片 时 ， 每 次 迭代 会 返回 两 个 值 。 第 一 个 值 是 迭代 的 元 素 在 
切片 里 的 索引 位 置 ， 第 二 个 值 是 元 素 值 的 一 个 副本 。 


如 果 仔 细 看 一 下 第 30 行 的 for range 语句 ， 会 发 现 再 次 使 用 了 下 划 
线 标识 符 ， 如 代码 清单 2-20 所 示 。 





代码 清单 2-20 ”search/search.go: 第 29 行 到 第 30 行 











// 为 每 个 数据 源 启动 一 个 goroutine 来 查找 结果 


for , feed := range feeds { 





这 是 第 二 次 看 到 使 用 了 下 划 线 标识 符 。 第 一 次 是 在 main.go 里 导 
入 matchers 包 的 时 候 。 这 次 ， 下 划 线 标识 符 的 作用 是 占 位 符 ， 占 据 了 
保存 range 调用 返回 的 索引 值 的 变量 的 位 置 。 如 果 要 调用 的 函数 返回 多 
个 值 ， 而 又 不 需要 其 中 的 某 个 值 ， 就 可 以 使 用 下 划 线 标识 符 将 其 忽略 。 
在 我 们 的 例子 里 ， 我 们 不 需要 使 用 返回 的 索引 值 ， 所 以 就 使 用 下 划 线 标 
识 符 把 它 忽略 掉 。 


在 循环 中 ， 我 们 首先 通过 map 查找 到 一 个 可 用 于 处 理 特定 数据 源 类 
型 的 数据 的 Matcher 值 ， 如 代码 清单 2-21 所 示 。 











代码 清单 2-21 search/search.go: 第 31 行 到 第 35 行 























31 // 获取 一 个 匹配 器 用 于 碍 找 
32 matcher，exists := matchers[feed.Type] 
33 if lexists { 


34 matcher = matchers["default"] 


我 们 还 没有 说 过 map 里 面 的 值 是 如 何 获 得 的 。 一 会 儿 就 会 在 程序 初 
始 化 的 时 候 看 到 如 何 设置 map 里 的 值 。 在 第 32 行 ， 我 们 检查 map 是 否 含 
有 符合 数据 源 类 型 的 值 。 查 找 map 里 的 键 时 ， 有 两 个 选择 : 要 么 赋值 给 
一 个 变量 ， 要 么 为 了 精确 碍 找 ， 赋 值 给 两 个 变量 。 赋 值 给 两 个 变量 时 第 
一 个 值 和 赋值 给 一 个 变量 时 的 值 一 样 ， 是 map 得 找 的 结果 值 。 如 果 指 定 
了 第 二 个 值 ， 就 会 返回 一 个 布尔 标志 ， 来 表示 碍 找 的 键 是 售 存 在 于 map 
里 。 如 果 这 个 键 不 存在 ，map 会 返回 其 值 类 型 的 零 值 作为 返回 值 ， 如 果 
这 个 键 存 在 ，map 会 返回 键 所 对 应 值 的 副本 。 


在 第 33 行 ， 我 们 检查 这 个 键 是 否 存在 于 map 里 。 如 果 不 存 在 ， 使 用 
默认 匹配 器 。 这 样 程序 在 不 知道 对 应 数据 源 的 具体 类 型 时 ， 也 可 以 执 
之 后 ， 局 动 一 个 goroutine 来 执行 搜索 ， 如 代码 清单 2- 
22 贞 不 。 














代码 清单 2-22 ”search/search.go: 第 37 行 到 第 41 行 





// 局 动 一 个 goroutine 来 执行 搜索 
go func(matcher Matcher, feed *Feed) { 





Match(matcher, feed, searchTerm, results) 
waitGroup .Done() 
}(matcher, feed) 





我 们 会 在 第 6 章 进 一 步 学 习 goroutine， 现 在 只 要 知道 ， 一 个 goroutine 
是 一 个 独立 于 其 他 函数 运行 的 函数 。 使 用 关键 字 go 启动 一 个 goroutine， 
并 对 这 个 goroutine 做 并 发 调度 。 在 第 38 行 ， 我 们 使 用 关键 字 go 启动 了 一 
个 匿名 函数 作为 goroutine。 匿 名 函数 是 指 没 有 明确 声明 名 字 的 函数 。 
在 for range 循环 里 ， 我 们 为 每 个 数据 源 ， 以 goroutine 的 方式 启动 了 一 
个 匿名 函数 。 这 样 可 以 并 发 地 独立 处 理 每 个 数据 源 的 数据 。 


匿名 函数 也 可 以 接受 声明 时 指定 的 参数 。 在 第 38 行 ， 我 们 指定 匿名 
函数 要 接受 两 个 参数 ， 一 个 类 型 为 Matcher ， 另 一 个 是 指向 一 个 Feed 
类 型 值 的 指针 。 这 意味 着 变量 feed 是 一 个 指针 变量 。 指 针 变 量 可 以 方 
便 地 在 函数 之 间 共 享 数据 。 使 用 指针 变量 可 以 让 函数 访问 并 修改 一 个 变 
量 的 状态 ， 而 这 个 变量 可 以 在 其 他 函数 甚至 是 其 他 goroutine 的 作用 域 里 
声明 。 




















在 第 41 行 ，matcher 和 feed 两 个 变量 的 值 被 传 入 匿名 函数 。 在 Go 
语言 中 ， 所 有 的 变量 都 以 值 的 方式 传递 。 因 为 指针 变量 的 值 是 所 指 回 的 
内 存 地 址 ， 在 函数 间 传 递 指针 变量 ， 是 在 传递 这 个 地 址 值 ， 所 以 依旧 被 
看 作 以 值 的 方式 在 传递 。 


在 第 39 行 到 第 40 行 ， 可 以 看 到 每 个 goroutine 是 如 何 工 作 的 ， 如 代码 
清单 2-23 所 示 。 











代码 清单 2-23 ”search/search.go: 第 39 行 到 第 40 行 





39 Match(matcher, feed, searchTerm, results) 
40 waitGroup.Done() 


goroutine 做 的 第 一 件 事 是 调用 一 个 叫 Match 的 函数 ， 这 个 函数 可 以 
在 match.go 文 件 里 找到 。Match 函数 的 参数 是 一 个 Matcher 类 型 的 值 、 
一 个 指 同 Feed 类 型 值 的 指针 、 搜 索 项 以 及 输出 结果 的 通道 。 我 们 一 会 
儿 再 看 这 个 函数 的 内 部 细节 ， 现 在 只 要 知道 ，Match 函数 会 搜索 数据 源 
的 数据 ， 并 将 匹配 结果 输出 到 results 通道 。 


一 旦 Match 函数 调用 完毕 ， 就 会 执行 第 40 行 的 代码 ， 弟 减 
WaitGroup 的 计数 。 一 旦 每 个 goroutine 都 执行 调用 Match 函数 和 Done 
方法 ， 程 序 就 知道 每 个 数据 源 都 处 理 完 成 。 调 用 Done 方法 这 一 行 还 有 

-个 值得 注意 的 细节 : WaitGroup 的 值 没 有 作为 参数 传 入 匿名 函数 ， 但 
是 匿名 函数 依旧 访问 到 了 这 个 值 。 


Go 语言 文 持 财 包 ， 这 里 就 应 用 了 闭 包 。 实 际 上 ， 在 匿名 函数 内 访 
问 searchTerm 和 results 变量 ， 也 是 通过 闭 包 的 形式 访问 的 。 因 为 有 
了 闭 包 ， 函 数 可 以 直接 访问 到 那些 没有 作为 参数 传 入 的 变量 。 匿 名 函数 
并 没有 拿 到 这 些 变量 的 副本 ， 而 是 直接 访问 外 层 函 数 作 用 域 中 声明 的 这 
些 变量 本 身 。 因 为 matcher 和 feed 变量 每 次 调用 时 值 不 相同 ， 所 以 并 
没有 使 用 闭 包 的 方式 访问 这 两 个 变量 ， 如 代码 清单 2-24 所 示 。 


代码 清单 2-24 ”search/search.go: 第 29 行 到 第 32 行 
































29 // 为 每 个 数据 源 启动 一 个 goroutine 来 查找 结果 
36 for , feed := range feeds { 


31 // 获取 一 个 匹配 器 用 于 查找 


32 matcher, exists := matchers[feed.Type] 




















可 以 看 到 ， 在 第 30 行 到 第 32 行 ， 变 量 feed 和 matcher 的 值 会 随 着 
循环 的 迭代 而 改变 。 如 果 我 们 使 用 闭 包 访问 这 些 变 量 ， 随 着 外 层 函 数 里 
变量 值 的 改变 ， 内 层 的 匿名 函数 也 会 感知 到 这 些 改变 。 所 有 的 goroutine 
都 会 因为 闭 包 共享 同样 的 变量 。 除 非 我 们 以 函数 参数 的 形式 传 值 给 函 
数 ， 否 则 绝 大 部 分 goroutine 最 终 都 会 使 用 同一 个 matcher 来 处 理 同一 
个 feed 一 一 这 个 值 很 有 可 能 是 feeds 切片 的 最 后 一 个 值 。 

随 着 每 个 goroutine 搜 索 工 作 的 运行 ， 将 结果 发 送 到 results 通道 ， 
并 递减 waitGroup 的 计数 ， 我 们 需要 一 种 方法 来 显示 所 有 的 结果 ， 并 让 
main 函数 持续 工作 ， 直 到 完成 所 有 的 操作 ， 如 代码 清单 2-25 所 示 。 


代码 清单 2-25 ”search/search.go: 第 44 行 到 第 57 行 

















// 局 动 一 个 goroutine 来 监控 是 否 所 有 的 工作 都 做 完了 
go func() { 

// 等 候 所 有 任务 完成 

waitGroup .Wait() 
































// 用 关闭 通道 的 方式 ， 通 知 Display 函 数 
// 可 以 退出 程序 了 
close(results) 


}() 

















// 启动 函数 ， 显 示 返 回 的 结果 ， 
// 并 且 在 最 后 一 个 结果 显示 完 后 返回 
Display(results) 




















第 45 行 到 第 56 行 的 代码 解释 起 来 比较 嘛 烦 ， 等 我 们 看 完 search 包 
里 的 其 他 代码 后 再 来 解释 。 我 们 现在 只 解释 表面 的 语法 ， 随 后 再 来 解释 
底层 的 机 制 。 在 第 45 行 到 第 52 行 ， 我 们 以 goroutine 的 方式 启动 了 另 一 个 
匿名 函数 。 这 个 匿名 函数 没有 输入 参数 ， 使 用 财 包 访 问 了 WaitGroup 和 
results 变量 。 这 个 goroutine 里 面 调用 了 WaitGroup 的 Wait 方法 。 这 
个 方法 会 导致 goroutine 阳 寨 ， 直 到 WaitGroup 内 部 的 计数 到 达 0。 之 
goroutine 调 用 了 内 置 的 close 函数 ， 关 闭 了 通道 ， 最 终 导致 程序 终 





Run 函数 的 最 后 一 段 代 码 是 第 56 行 。 这 行 调用 了 match.go 文 件 里 的 
Display 函数 。 一 旦 这 个 函数 返回 ， 程 序 就 会 终止 。 而 之 前 的 代码 保证 


了 所 有 results 通道 里 的 数据 被 处 理 之 前 ，Display 函数 不 会 返回 。 
2.3.2 feed.go 


现在 已 经 看 过 了 Run 函数 ， 让 我 们 继续 看 看 search.go 文 件 的 第 14 行 
中 的 RetrieveFeeds 函数 调用 背后 的 代码 。 这 个 函数 读 取 data.json 文 件 
并 返回 数据 源 的 切片 。 这 些 数据 源 会 输出 内 容 ， 随 后 使 用 各 自 的 匹配 器 
进行 搜索 。 代 码 清单 2-26 给 出 的 是 feed.go 文 件 的 前 8 行 代码 。 


代码 清单 2-26 feed.go: 第 01 行 到 第 08 行 


























61 package search 

02 

863 import ( 
"encoding/json" 


68 const dataFile = "data/data.json" 





这 个 代码 文件 在 search 文件 夹 里 ， 所 以 第 01 行 声明 了 包 的 名 字 
为 search 。 第 03 行 到 第 06 行 导入 了 标准 库 中 的 两 个 包 。json 包 提 供 编 
解码 JSON 的 功能 ，os 包 提 供 访 问 操 作 系 统 的 功能 ， 如 读 文 件 。 


读者 可 能 注意 到 了 ， 导 入 json 包 的 时 候 需要 指定 encoding 路 径 。 
不 考虑 这 个 路 径 的 话 ， 我 们 导入 包 的 名 字 叫 作 json 。 不 管 标准 库 的 路 
径 是 什么 样 的 ， 并 不 会 改变 包 名 。 我 们 在 访问 json 包 内 的 函数 时 ， 依 
旧 是 指定 json 这 个 名 字 。 


在 第 08 行 ， 我 们 声明 了 一 个 叫 作 dataFile 的 常量 ， 使 用 内 容 是 磁 
盘 上 根据 相对 路 径 指定 的 数据 文件 名 的 字符 串 做 初始 化 。 因 为 Go 编译 
融 可 以 根据 赋值 运算 符 右 边 的 值 来 推导 类 型 ， 声 明 癌 量 的 时 候 不 需要 指 
定 类 型 。 此 外 ， 这 个 第 量 的 名 称 使 用 小 写字 和 母 开头 ， 表 示 它 只 能 
在 search 包 内 的 代码 里 直接 访问 ， 而 不 暴露 到 包 外 面 。 


接着 我 们 来 看 看 data.json 数据 文件 的 部 分 内 容 ， 如 代码 清单 2-27 
不 





























代码 清单 2-27 data.json 





"npr", 
"http://www.npr.org/rss/rss.php?id=1661 


“Cnn ， 
"http://rss.cnn.com/rss/cnn world.rss 


"foxnews",， 
"http://feeds.foxnews.com/foxnews/world?format=xml 


"nbcnews", 
"http://feeds.nbcnews.com/feeds/topstories 





为 了 保证 数据 的 有 效 性 ， 代 码 清 单 2-27 只 选用 了 4 个 数据 源 ， 实 际 
数据 文件 包含 的 数据 要 比 这 4 个 多 。 数 据 文件 包括 一 个 JSON 文 档 数组 。 
数组 的 每 一 项 都 是 一 个 JSON 文 档 ， 包 含 获取 数据 的 网 站 名 、 数 据 的 链 
接 以 及 我 们 期 望 获得 的 数据 类 型 。 

这 些 数 据 文档 需要 解码 到 一 个 结构 组 成 的 切片 里 ， 以 便 我 们 能 在 程 
来 看 看 用 于 解码 数据 文档 的 结构 类 型 ， 如 代码 清单 
2-28 有 不 。 


代码 清单 2-28 feed.go: 第 10 行 到 第 15 行 











16 // Feed 包含 我 们 需要 处 理 的 数据 源 的 信息 
11 type Feed struct { 

12 Name string “json:"site". 

13 URI string ‘json:"link". 


14 Type string json: "type” 
15 } 





在 第 11 行 到 第 15 行 ， 我 们 声明 了 一 个 名 叫 Feed 的 结构 类 型 。 这 个 
类 型 会 对 外 暴露 。 这 个 类 型 里 面 声明 了 3 个 字段 ， 每 个 字段 的 类 型 都 是 
字符 串 ， 对 应 于 数据 文件 中 各 个 文档 的 不 同 字段 。 每 个 字段 的 声明 最 后 
` 引号 里 的 部 分 被 称 作 标 记 (tag) 。 这 个 标记 里 描述 了 JSON 解 码 的 元 
数据 ， 用 于 创建 Feed 类 型 值 的 切片 。 每 个 标记 将 结构 类 型 里 字段 对 应 
到 JSON 文 档 里 指定 名 字 的 字段 。 

现在 可 以 看 看 search.go 代 码 文件 的 第 14 行 中 调用 的 RetrieveFeeds 
函数 了 。 这 个 函数 读 取 数 据 文 件 ， 并 将 每 个 JSON 文 档 解码 ， 存 入 一 
个 Feed 类 型 值 的 切片 里 ， 如 代码 清单 2-29 所 示 。 


代码 清 


























2-29 ”feed.go: 第 17 行 到 第 36 行 











17 // RetrieveFeeds 读 取 并 反 序 列 化 源 数据 文件 
18 func RetrieveFeeds() ([]*Feed，error) { 
// 打开 文件 
file, err := 0s.0pen(dataFile) 
if err != nil { 
return nil, err 





} 


// 当 函 数 返回 时 
// 关闭 文件 
defer file.Close() 

















// 将 文件 解码 到 一 个 切片 里 
// 这 个 切片 的 每 一 项 是 一 个 指向 一 个 Feed 类 型 值 的 指针 
var feeds []*Feed 

err = json.NewDecoder(file).Decode(&feeds) 






































// 这 个 函数 不 需要 检查 错误 ， 调 用 者 会 做 这 件 寻 


return feeds, err 











让 我 们 从 第 18 行 的 函数 声明 开始 。 这 个 函数 没有 参数 ， 会 返回 两 个 
值 。 第 一 个 返回 值 是 一 个 切片 ， 其 中 每 一 项 指 癌 一 个 Feed 类 型 的 值 。 
第 二 个 返回 值 是 一 个 error 类 型 的 值 ， 用 来 表示 函数 是 否 调 用 成 功 。 在 
这 个 代码 示例 里 ， 会 经 常 看 到 返回 error 类 型 值 来 表示 函数 是 否 调用 成 
功 。 这 种 用 法 在 标准 库 里 也 很 常见 。 


现在 让 我 们 看 看 第 20 行 到 第 23 行 。 在 这 几 行 里 ， 我 们 使 用 os 包 打 
开 了 数据 文件 。 我 们 使 用 相对 路 径 调用 Open 方法 ， 并 得 到 两 个 返回 
值 。 第 一 个 返回 值 是 一 个 指针 ， 指 向 File 类 型 的 值 ， 第 二 个 返回 值 
是 error 类 型 的 值 ， 检 查 0pen 调用 是 否 成 功 。 紧 接着 第 21 行 就 检查 了 
返回 的 error 类 型 错误 值 ， 如 果 打 开 文 件 真 的 有 问题 ， 就 把 这 个 错误 值 
返回 给 调用 者 。 


如 果 成 功 打 开 了 文件 ， 会 进入 到 第 27 行 。 这 里 使 用 了 关键 字 defer 
， 如 代码 清单 2-30 所 示 。 























代码 清单 2-30 feed.go: 第 25 行 到 第 27 行 

















// 当 函 数 返 回 时 
// 关闭 文件 





defer file.Close() 





关键 字 defer 会 安排 随后 的 函数 调用 在 函数 返回 时 才 执 行 。 在 使 用 
完 文 件 后 ， 需 要 主动 关闭 文件 。 使 用 关键 字 defer 来 安排 调用 Close 方 
法 ， 可 以 保证 这 个 函数 一 定 会 被 调用 。 哪 怕 函 数 意 外 般 溃 终止 ， 也 能 保 
证 关键 字 defer 安排 调用 的 函数 会 被 执行 。 关 键 字 defer 可 以 缩短 打开 
文件 和 关闭 文件 之 间 间 隔 的 代码 行 数 ， 有 助 提高 代码 可 读 性 ， 减 少 错 
误 。 


现在 可 以 看 看 这 个 函数 的 最 后 几 行 ， 如 代码 清单 2-31 所 示 。 先 来 看 
一 下 第 31 行 到 第 35 行 的 代码 。 

















代码 清单 2-31 feed.go: 第 29 行 到 第 36 行 
































29 // 将 文件 解码 到 一 个 切片 里 











36 // 这 个 切片 的 每 一 项 是 一 个 指向 一 个 Feed 类 型 值 的 指针 
31 var feeds []*Feed 
32 err = json.NewDecoder(file).Decode(&feeds) 























34 // 这 个 函数 不 需要 检查 错误 ， 调 用 者 会 做 这 件 事 
35 return feeds, err 











在 第 31 行 我 们 声明 了 一 个 名 字 叫 feeds ， 值 为 nil 的 切片 ， 这 个 切 
片 包含 一 组 指向 Feed 类 型 值 的 指针 。 之 后 在 第 32 行 我 们 调用 json 包 的 
NewDecoder 函数 ， 然 后 在 其 返回 值 上 调用 Decode 方法 。 我 们 使 用 之 
前 调用 0pen 返回 的 文件 句柄 调用 NewDecoder 函数 ， 并 得 到 一 个 指 
癌 Decoder 类 型 的 值 的 指针 。 之 后 再 调用 这 个 指针 的 Decode 方法 ， 传 
入 切片 的 地 址 。 之 后 Decode 方法 会 解码 数据 文件 ， 并 将 解码 后 的 值 以 
Feed 类 型 值 的 形式 存 入 切片 里 。 


根据 Decode 方法 的 声明 ， 该 方法 可 以 接受 任何 类 型 的 值 ， 如 代码 
清单 2-32 所 示 。 


代码 清单 2-32 ”使 用 空 interface 


func (dec *Decoder) Decode(v interface{}) error 


Decode 方法 接受 一 个 类 型 为 jnterface{} 的 值 作为 参数 。 这 个 类 
型 在 Go 语言 里 很 特殊 ， 一 般 会 配合 reflect 包 里 提供 的 反射 功能 一 起 
使 用 。 


最 后 ， 第 35 行 给 函数 的 调用 者 返回 了 切片 和 错误 值 。 在 这 个 例子 
里 ， 不 需要 对 Decode 调用 之 后 的 错误 做 检查 。 函 数 执 行 结束 ， 这 个 函 
数 的 调用 者 可 以 检查 这 个 错误 值 ， 并 决定 后 续 如 何 处 理 。 


现在 让 我 们 看 看 搜索 的 代码 是 如 何 支 持 不 同类 型 的 数据 源 的 。 让 我 
们 去 看 看 匹配 器 的 代码 。 








2.3.3 match.go/default.go 


match.go 代 码 文件 包含 创建 不 同类 型 匹配 器 的 代码 ， 这 些 匹配 需 用 
于 在 Run 函数 里 对 数据 进行 搜索 。 让 我 们 回头 看 看 Run 函数 里 使 用 不 同 
匹配 右 执 行 搜 索 的 代码 ， 如 代码 清单 2-33 所 示 。 


代码 清单 2-33 ”search/search.go: 第 29 行 到 第 42 行 

















// 为 每 个 数据 源 启动 一 个 goroutine 来 查找 结果 
for , feed := range feeds { 
// 获取 一 个 匹配 器 用 于 查找 
matcher, exists := matchers[feed.Type] 
if lexists { 
matcher = matchers["default"] 





} 


// 启动 一 个 goroutine 执 行 查找 

go func(matcher Matcher, feed *Feed) { 
Match(matcher, feed, searchTerm, results) 
waitGroup .Done() 

}(matcher, feed) 











代码 的 第 32 行 ， 根 据 数 据 源 类 型 查找 一 个 匹配 器 值 。 这 个 逻 配 器 值 
随后 会 用 于 在 特定 的 数据 源 里 处 理 搜索 。 之 后 在 第 38 行 到 第 41 行 局 动 了 
一 个 goroutine， 让 [匹配 器 对 数据 源 的 数据 进行 搜索 。 让 这 段 代 码 起 作用 
的 关键 是 这 个 架构 使 用 一 个 接口 类 型 来 匹配 并 执行 具有 特定 实现 的 匹配 
器 。 这 样 ， 束 能 使 用 这 段 代 码 ， 以 一 致 且 通用 的 方法 ， 来 处 理 不 同类 型 
让 我 们 看 一 下 match.go 里 的 代码 ， 看 看 如 何 才 能 实现 这 一 
功能 。 


代码 清单 2-34 给 出 的 是 match.go 的 前 17 行 代码 。 


代码 清单 2-34 ”search/match.go: 第 01 行 到 第 17 行 
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863 import ( 
64 "log 
65 ) 

66 


67 // Result 保 存 搜索 的 结果 
68 type Result struct { 


69 Field string 
16 Content string 
11 } 

12 





13 // Matcher 定 义 了 要 实现 的 

14 // 新 搜索 类 型 的 行为 

15 type Matcher interface { 

16 Search(feed *Feed, searchTerm string) ([]*Result, error) 








17 } 


让 我 们 看 一 下 第 15 行 到 第 17 行 ， 这 里 声明 了 一 个 名 为 Matcher 的 接 
口 类 型 。 之 前 ， 我 们 只 见 过 声明 结构 类 型 ， 而 现在 看 到 如 何 声 明 一 
个 interface (接口 ) 类 型 。 我 们 会 在 第 5 章 介 绍 接口 的 更 多 细节 ， 现 
在 只 需要 知道 ，interface 关键 字 声 明了 一 个 接口 ， 这 个 接口 声明 了 结 
构 类 型 或 者 具名 类 型 需要 实现 的 行为 。 一 个 接口 的 行为 最 终 由 在 这 个 接 
口 类 型 中 声明 的 方法 决定 。 


对 于 Matcher 这 个 接口 来 说 ， 只 声明 了 一 个 Search 方法 ， 这 个 方 
法 输入 一 个 指向 Feed 类 型 值 的 指针 和 一 个 string 类 型 的 搜索 项 。 这 个 
方法 返回 两 个 值 ， 一 个 指向 Result 类 型 值 的 指针 的 切片 ， 另 一 个 是 错 
误 值 。Result 类 型 的 声明 在 第 08 行 到 第 11 行 。 


命名 接口 的 时 候 ， 也 需要 遵守 Go 语言 的 命名 惯例 。 如 果 接 口 类 型 
只 包含 一 个 方法 ， 那 么 这 个 类 型 的 名 字 以 er 结尾 。 我 们 的 例子 里 就 是 
这 么 做 的 ， 所 以 这 个 接口 的 名 字 叫 作 Matcher 。 如 果 接 口 类 型 内 部 声明 
了 多 个 方法 ， 其 名 字 需 要 与 其 行为 关联 。 

如 果 要 让 一 个 用 户 定义 的 类 型 实现 一 个 接口 ， 这 个 用 户 定义 的 类 型 
要 实现 接口 类 型 里 声明 的 所 有 方法 。 让 我 们 切换 到 default.go 代 码 文件 ， 
看 看 默认 匹配 器 是 如 何 实现 Matcher 接口 的 ， 如 代码 清单 2-35 所 示 。 


代码 清单 2-35 search/default.go: 第 01 行 到 第 15 行 
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63 // defaultMatcher 实 现 了 默认 匹配 器 
64 type defaultMatcher struct{} 








66 // init 函 数 将 默认 匹配 器 注册 到 程序 里 
867 func init() { 


68 var matcher defaultMatcher 
69 Register("default", matcher) 
16 } 

11 


12 // Search 实现 了 默认 匹配 器 的 行为 

13 func (m defaultMatcher) Search(feed *Feed, searchTerm string) ([]*Resul 
t, error) { 

14 return nil, nil 

15 } 


[L 


在 第 04 行 ， 我 们 使 用 一 个 空 结构 声明 了 一 个 名 MUdefaultMatcher 
的 结构 类 型 。 空 结构 在 创建 实例 时 ， 不 会 分 配 任何 内 存 。 这 种 结构 很 适 
合 创 建 没有 任何 状态 的 类 型 。 对 于 默认 匹配 器 来 说 ， 不 需要 维护 任何 状 
态 ， 所 以 我 们 只 要 实现 对 应 的 接口 就 行 。 


在 第 13 行 到 第 15 行 ， 可 以 看 到 defaultMatcher 类 型 实现 Matcher 
接口 的 代码 。 实 现 接口 的 方法 search 只 返回 两 个 nil 值 。 其 他 的 实 
现 ， 如 RSS[ 匹 配器 的 实现 ， 会 在 这 个 方法 里 使 用 特定 的 业务 逻辑 规则 来 
处 理 搜索 。 


Search 方法 的 声明 也 声明 了 defaultMatcher 类 型 的 值 的 接收 
者 ， 如 代码 清单 2-36 所 示 。 

















代码 清单 2-36 ”search/default.go: 第 13 行 


13 func (m defaultMatcher) Search 


如 果 声 明 函 数 的 时 候 带 有 接收 者 ， 则 意味 着 声明 了 一 个 方法 。 这 个 
方法 会 和 指定 的 接收 者 的 类 型 绑 在 一 起 。 在 我 们 的 例子 里 ，Search 方 
法 与 defaultMatcher 类 型 的 值 绑 在 一 起 。 这 意味 着 我 们 可 以 使 
用 defaultMatcher 类 型 的 值 或 者 指向 这 个 类 型 值 的 指针 来 调 
用 Search 方法 。 无 论 我 们 是 使 用 接收 者 类 型 的 值 来 调用 这 个 方 ， 还 是 
使 用 接收 者 类 型 值 的 指针 来 调用 这 个 方法 ， 编 译 器 都 会 正确 地 引用 或 者 
解 引 用 对 应 的 值 ， 作 为 接收 者 传递 给 Search 方法 ， 如 代码 清单 2-37 所 
示 




















代码 清单 2-37 调用 方法 的 例子 




















// 方法 声明 为 使 用 defaultMatcher 类 型 的 值 作为 接收 者 


func (m defaultMatcher) Search(feed *Feed, searchTerm string) 








// 声明 一 个 指向 defaultMatcher 类 型 值 的 指针 
dm := new(defaultMatch) 








// 编译 器 会 解 开 dm 指针 的 引用 ， 使 用 对 应 的 值 调用 方法 
dm.Search(feed, "test") 








// 方法 声明 为 使 用 指向 defaultMatcher 类 型 值 的 指针 作为 接收 者 








func (m *defaultMatcher) Search(feed *Feed, searchTerm string) 


// 声明 一 个 defaultMatcher 类 型 的 值 
var dm defaultMatch 
































// 编译 器 会 自动 生成 指针 引用 dm 值 ， 使 用 指针 调用 方法 
dm.Search(feed, "test") 



































因为 大 部 分 方法 在 被 调用 后 都 需要 维护 接收 者 的 值 的 状态 ， 所 以 ， 
一 个 最 佳 实践 是 ， 将 方法 的 接收 者 声明 为 指针 。 对 于 defaultMatcher 
类 型 来 说 ， 使 用 值 作为 接收 者 是 因为 创建 一 个 defaultMatcher 类 型 的 
值 不 需要 分 配 内 存 。 由 于 defaultMatcher 不 需要 维护 状态 ， 所 以 不 需 
要 指针 形式 的 接收 者 。 


与 直接 通过 值 或 者 指针 调用 方法 不 同 ， 如 有 果 通 过 接口 类 型 的 值 调用 
方法 ， 规 则 有 很 大 不 同 ， 如 代码 清单 2-38 所 示 。 使 用 指针 作为 接收 者 声 
明 的 方法 ， 只 能 在 接口 类 型 的 值 是 一 个 指针 的 时 候 被 调用 。 使 用 值 作为 
接收 者 声明 的 方法 ， 在 接口 类 型 的 值 为 值 或 者 指针 时 ， 都 可 以 极 调 用 。 


代码 清单 2-38 接口 方法 调用 所 受 限 制 的 例子 












































// 方法 声明 为 使 用 指向 defaultMatcher 类 型 值 的 指针 作为 接收 者 


func (m *defaultMatcher) Search(feed *Feed, searchTerm string) 





























// 通过 interface 类 型 的 值 来 调用 方法 

var dm defaultMatcher 

var matcher Matcher = dm // 将 值 赋值 给 接口 类 型 
matcher.Search(feed,，"test") // 使 用 值 来 调用 接口 方法 









































> go build 
cannot use dm (type defaultMatcher) as type Matcher in assignment 





// 方法 声明 为 使 用 defaultMatcher 类 型 的 值 作为 接收 者 


func (m defaultMatcher) Search(feed *Feed, searchTerm string) 

















// 通过 interface 类 型 的 值 来 调用 方法 

var dm defaultMatcher 

var matcher Matcher = &dm // 将 指针 赋值 给 接口 类 型 
matcher.Search(feed，"test") // 使 用 指针 来 调用 接口 方法 




















> go build 
Build Successful 





除了 Search 方法 ，defaultMatcher 类 型 不 需要 为 实现 接口 做 更 
多 的 事情 了 。 从 这 上 段 代 码 之 后 ， 不 论 是 defaultMatcher 类 型 的 值 还 是 
指针 ， 都 满足 Matcher 接口 ， 都 可 以 作为 Matcher 类 型 的 值 使 用 。 这 是 
代码 可 以 工作 的 关键 。defaultMatcher 类 型 的 值 和 指针 现在 还 可 以 作 
为 Matcher 的 值 ， 赋 值 或 者 传递 给 接受 Matcher 类 型 值 的 函数 。 


让 我 们 看 看 match.go 代 码 文 件 里 实现 Match 函数 的 代码 ， 如 代码 清 
和 这 个 函数 在 search.go 代 码 文件 的 第 39 行 中 由 Run 函数 调 











代码 清单 2-39 ”search/match.go: 第 19 行 到 第 33 行 





19 // Match 冰 数 ， 为 每 个 数据 源 单独 启动 goroutine 来 执行 这 个 函数 
26 // 并 发 地 执行 搜索 
21 func Match(matcher Matcher, feed *Feed, searchTerm string, results chan 
<- *Result) { 
// 对 特定 的 匹配 器 执行 搜索 
searchResults, err := matcher.Search(feed, searchTerm) 
if err != nil { 
log.Println(err) 
return 








} 


// 将 结果 写 入 通道 
for , result := range searchResults { 
results <- result 





这 个 函数 使 用 实现 了 Matcher 接口 的 值 或 者 指针 ， 进 行 真 正 的 搜 
索 。 这 个 函数 接受 Matcher 类 型 的 值 作为 第 一 个 参数 。 只 有 实现 了 
Matcher 接口 的 值 或 者 指针 能 被 接受 。 因 为 defaultMatcher 类 型 使 用 
值 作为 接收 者 ， 实 现 了 这 个 接口 ， 所 以 defaultMatcher 类 型 的 值 或 者 
旨 针 可 以 传 入 这 个 函数 。 


在 第 23 行 ， 调 用 了 传 入 函数 的 Matcher 类 型 值 的 Search 方法 。 这 
里 执行 了 Matcher 变量 中 特定 的 Search 方法 。Search 方法 返回 后 ， 在 
第 24 行 检测 返回 的 错误 值 是 否 真 的 是 一 个 错误 。 如 果 是 一 个 错误 ， 函 数 
通过 1og 输出 错误 信息 并 返回 。 如 果 搜 索 并 没有 返回 错误 ， 而 是 返回 了 
搜索 结果 ， 则 把 结果 写 入 通道 ， 以 便 正 在 监听 通道 的 main 函数 就 能 收 




















到 这 些 结果 。 

match.go 中 的 最 后 一 部 分 代码 就 是 main 函数 在 第 56 行 调用 的 
Display 函数 ， 如 代码 清单 2-40 所 示 。 这 个 函数 会 阻止 程序 终止 ， 直 到 
接收 并 输出 了 搜索 goroutine 返 回 的 所 有 结果 。 


代码 清单 2-40 ”search/match.go: 第 35 行 到 第 43 行 

















// Display 从 每 个 单独 的 goroutine 接 收 到 结果 后 
// 在 终端 窗口 输出 
func Display(results chan *Result) { 

// 通道 会 一 直 被 阻塞 ， 直 到 有 结果 写 入 

// 一 旦 通道 被 关闭，for 循 环 就 会 终止 



































for result := range results { 
fmt.Printf("%s:\n%s\n\n", result.Field, result.Content) 
} 








当 通 道 被 关闭 时 ， 通 道 和 关键 字 range 的 行为 ， 使 这 个 函数 在 处 理 
完 所 有 结果 后 才 会 返回 。 让 我 们 再 来 简单 看 一 下 Run 函数 的 代码 ， 特 别 
是 关闭 results 通道 并 调用 Display 函数 那 段 ， 如 代码 清单 2-41 所 示 。 


代码 清单 2-41 search/search.go: 第 44 行 到 第 57 行 

















// 启动 一 个 goroutine 来 监控 是 否 所 有 的 工作 都 做 完了 
go func() { 

// 等 候 所 有 任务 完成 

waitGroup.Wait() 











// 用 关闭 通道 的 方式 ， 通 知 Display 函 数 
// 可 以 退出 程序 了 
close(results) 


}() 














// 启动 函数 ， 显 示 返 回 的 结果 ， 
// 并 且 在 最 后 一 个 结果 显示 完 后 返 
Display(results) 


























第 45 行 到 第 52 行 定义 的 goroutine 会 等 待 waitGroup ， 直 到 搜索 
goroutine 调 用 了 Done 方法 。 一 旦 最 后 一 个 搜索 goroutine 调 用 了 Done 


，Wait 方法 会 返回 ， 之 后 第 51 行 的 代码 会 关闭 results 通道 。 一 旦 通 
道 关 财 ，goroutine 就 会 终止 ， 不 再 工作 。 


在 match.go 代 码 文件 的 第 30 行 到 第 32 行 ， 搜 索 结果 会 被 写 入 通道 ， 
如 代码 清单 2-42 所 示 。 





代码 清单 2-42 ”search/match.go: 第 29 行 到 第 32 行 








// 将 结果 写 入 通道 
for , result := range searchResults { 


results <- result 


} 








如 果 回 头 看 一 看 match.go 代 码 文件 的 第 40 行 到 第 42 行 的 for range 
循环 ， 如 代码 清单 2-43 所 示 ， 我 们 就 能 把 写 入 结果 、 关 闭 通 道 和 处 理 结 
果 这 些 流程 串 在 一 起 。 





代码 清单 2-43 ”search/match.go: 第 38 行 到 第 42 行 














// 通道 会 一 直 被 阻塞 ， 直 到 有 结果 写 入 
// 一 旦 通道 被 关闭 ，for 循 环 就 会 终止 
for result := range results { 














fmt.Printf("%s:\n%s\n\n", result.Field, result.Content) 


} 








match.go 代 码 文件 的 第 40 行 的 for range 循环 会 一 直 阻 塞 ， 直 到 有 
结果 写 入 通道 。 在 某 个 搜索 goroutine 向 通道 写 入 结果 后 (如 在 match.go 
代码 文件 的 第 31 行 所 见 ) ，for range 循环 被 唤醒 ， 读 出 这 些 结果 。 之 
后 ， 结 果 会 立刻 写 到 日 志 中 。 看 上 去 这 个 for range 循环 会 无 限 循 环 下 
去 ， 但 其 实 不 然 。 一 旦 search.go 代 码 文件 第 51 行 天 闭 了 通道 ，for 
range 循环 就 会 终止 ， Display 函数 也 会 返回 。 


在 我 们 去 看 RSS 匹 配器 的 实现 之 前 ， 再 看 一 下 程序 开始 执行 时 ， 如 
何 初始 化 不 同 的 匹配 器 。 为 此 ， 我 们 需要 先 回 头 看 看 default.go 代 码 文件 
的 第 07 行 到 第 10 行 ， 如 代码 清单 2-44 所 示 。 


代码 清单 2-44 search/default.go: 第 06 行 到 第 10 行 
































66 // init 函 数 将 默认 匹配 器 注册 到 程序 里 





867 func init() { 


08 var matcher defaultMatcher 
69 Register("default", matcher) 
16 } 





在 代码 文件 default.go 里 有 一 个 特殊 的 函数 ， 名 叫 init 。 在 main.go 
代码 文件 里 也 能 看 到 同名 的 函数 。 我 们 之 前 说 过 ， 程 序 里 所 有 的 init 
方法 都 会 在 main 函数 启动 前 被 调用 。 让 我 们 再 看 看 main.go 代 码 文件 导 


入 了 哪些 代码 ， 如 代码 清单 2-45 所 示 。 











代码 清单 2-45 main.go: 第 07 行 到 第 08 行 

















_ "github.com/goinaction/code/chapter2/sample/matchers" 


"github.com/goinaction/code/chapter2/sample/search" 





第 8 行 导 入 search 包 ， 这 让 编译 器 可 以 找到 default.go 代 码 文 件 里 的 
init 函数 。 一 旦 编译 器 发 现 init 函数 ， 它 就 会 给 这 个 函数 优先 执行 的 
权限 ， 保 证 其 在 main 函数 之 前 被 调用 。 

代码 文件 default.go 里 的 init 函数 执行 一 个 特殊 的 任务 。 这 个 函数 
会 创建 一 个 defaultMatcher 类 型 的 值 ， 并 将 这 个 值 传递 给 search.go 代 
码 文 件 里 的 Register 函数 ， 如 代码 清单 2-46 所 示 。 


代码 清单 2-46 ”search/search.go: 第 59 行 到 第 67 行 





























59 // Register 调 用 时 ， 会 注册 一 个 匹配 器 ， 提 供给 后 面 的 程序 使 月 
66 func Register(feedType string, matcher Matcher) { 
if , exists := matchers[feedType]; exists { 

log.Fatalln(feedType, "Matcher already registered") 























} 


log.Println("Register", feedType, "matcher") 
matchers[feedType] = matcher 





这 个 函数 的 职责 是 ， 将 一 个 Matcher 值 加 入 到 保存 注册 匹配 器 的 映 
射 中 。 所 有 这 种 注册 都 应 该 在 main 函数 被 调用 前 完成 。 使 用 init 函数 
可 以 非常 完美 地 完成 这 种 初始 化 时 注册 的 任务 。 


2.4 RSS 克 配器 


最 后 要 看 的 一 部 分 代码 是 RSS 匹 配器 的 实现 代码 。 我 们 之 前 看 到 的 
代码 搭建 了 一 个 框架 ， 以 便 能 够 实现 不 同 的 匹配 器 来 搜索 内 容 。RSS 匹 
配 需 的 结构 与 默认 匹配 需 的 结构 很 类似 。 每 个 匹配 器 为 了 匹配 接 
口 ，Search 方法 的 实现 都 不 同 ， 因 此 匹配 器 之 间 无 法 互相 蔡 换 。 


代码 清单 2-47 中 的 RSS 文 档 是 一 个 例子 。 当 我 们 访问 数据 源 列表 里 
RSS 数 据 源 的 链接 时 ， 期 望 获 得 的 数据 就 和 这 个 例子 类 似 。 


代码 清单 2-47 ”期望 的 RSS 数 据 源 文档 























<rss xmlns:npr="http://www.npr.org/rss/ 


" xmlns:nprml="http://api" 
<channel> 
<title>News</title> 
<link>...</link> 
<description>...</description> 


<language>en</language> 
<Copyright>Copyright 2614 NPR - For Personal Use 
<image>...</imagey> 
<item> 
<title> 
Putin Says He '11 Respect Ukraine Vote But U.S. 
</title> 
<description> 
The White House and State Department have called on the 
</description> 





如 果 用 浏览 器 打开 代码 清单 2-47 中 的 任意 一 个 链接 ， 就 能 看 到 期 户 
的 RSS 文 档 的 完整 内 容 。RSS 匹 配器 的 实现 会 下 载 这 些 RSS 文 要 ， 使 用 
搜索 项 来 搜索 标题 和 描述 域 ， 并 将 结果 发 送 给 results 通道 。 让 我 们 先 
看 看 rss.go 代 码 文件 的 前 12 行 代码 ， 如 代码 清单 2-48 所 示 。 


代码 清单 2-48 ”matchers/rss.go: 第 01 行 到 第 12 行 


61 package matchers 
62 











63 import ( 


64 "encoding/xml" 

65 "errors" 

66 "fmt" 

67 "log" 

608 "net/http" 

69 "regexp" 

106 

11 "github.com/goinaction/code/chapter2/sample/search" 
12 ) 





和 其 他 代码 文件 一 样 ， 第 1 行 定义 了 包 名 。 这 个 代码 文件 处 于 名 叫 
matchers 的 文件 夹 中 ， 所 以 包 名 也 叫 matchers 。 之 后 ， 我 们 从 标准 





库 中 导入 了 6 个 库 ， 还 导入 了 search 包 。 再 一 次 ， 我 们 看 到 有 些 标 准 库 
的 包 是 从 标准 库 所 在 的 子 文件 夹 导入 的 ， 如 xml 和 http 。 就 像 json 包 
一 样 ， 路 径 里 最 后 一 个 文件 夹 的 名 字 代 表 包 的 名 字 。 


为 了 让 程序 可 以 使 用 文档 里 的 数据 ， 解 码 RSS 文 档 的 时 候 需 要 用 到 
4 个 结构 类 型 ， 如 代码 清单 2-49 所 示 。 











代码 清单 2-49 ”matchers/rss.go: 第 14 行 到 第 58 行 



































14 type ( 

15 // item 根 据 item 字 段 的 标签 ， 将 定义 的 字段 
16 // 与 rss 文 档 的 字段 关联 起 来 

17 item struct { 

18 XMLName xml.Name xml:"item". 

19 PubDate string ~xml:"pubDate". 
20 Title string ~ xml:"title". 
21 Description string ‘xml:"description" 
22 Link string ~ xml:"link". 

23 GUID string ~ xml:"guid". 

24 GeoRssPoint string xml:"georss:point". 
25 } 

26 

27 // image 根 据 image 字 段 的 标签 ， 将 定义 的 字段 
28 // 与 rss 文 档 的 字段 关联 起 来 

29 image struct { 

36 XMLName xml.Name “Xml1l:"image” 

31 URL string xml:"url". 

32 Title string xml:"title". 

33 Link string ~ xml:"link" 

34 } 


36 // _ channel 根据 channe1 字 段 的 标签 ， 将 定义 的 字段 
37 // 与 rss 文 档 的 字段 关联 起 来 





38 channel struct { 

39 XMLName xml.Name ~ xml:"channel". 

46 Title string ~xml:"title". 

41 Description string ~xml:"description". 
42 Link string ~ xml:"link" 

43 PubDate string ~xml:"pubDate". 

44 LastBuildDate string ~xml:"lastBuildDate". 
45 TTL string xml:"tt1l". 

46 Language string ~xml:"language". 

47 ManagingEditor string “xml:"managingEditor"、 
48 WebMaster string ~xml:"webMaster". 
49 Image image ~ xml:"image"、 

56 Item []item ~xml:"item". 

51 } 

52 

53 // rssDocument 定 义 了 与 rss 文 档 关 联 的 字段 

54 rssDocument struct { 

55 XMLName xml.Name xml:"rss". 

56 Channel channel xml:"channel". 

57 } 

58 ) 





如 果 把 这 些 结构 与 任意 一 个 数据 源 的 RSS 文 档 对 比 ， 就 能 发 现 它们 
的 对 应 关系 。 解 码 XML 的 方法 与 我 们 在 feed.go 代 码 文件 里 解码 JSON 文 
接 下 来 我 们 可 以 看 看 rssMatcher 类 型 的 声明 ， 如 代码 清单 2- 
50 所 不 。 























代码 清单 2-50 ”matchers/rss.go: 第 60 行 到 第 61 行 


66 // rssMatcher 实现 了 Matcher 接 口 





61 type rssMatcher struct{} 





再 说 明 一 次 ， 这 个 声明 与 defaultMatcher 类 型 的 声明 很 像 。 因 为 
不 需要 维护 任何 状态 ， 所 以 我 们 使 用 了 一 个 空 结 构 来 实现 Matcher 接 
口 。 接 下 来 看 看 思 配 器 init 函数 的 实现 ， 如 代码 清单 2-51 所 示 。 


代码 清单 2-51 matchers/rss.go: 第 63 行 到 第 67 行 























63 // init 将 匹配 器 注册 到 程序 里 
64 func init() { 


65 var matcher rssMatcher 
66 search.Register("rss", matcher) 





就 像 在 默认 匹配 器 里 看 到 的 一 样 ，init 函数 将 rssMatcher 类 型 的 
值 注 册 到 程序 里 ， 以 备 后 用 。 让 我 们 再 看 一 次 main.go 代 人 码 文件 里 的 导 


入 部 分 ， 如 代码 清单 2-52 所 示 。 











代码 清单 2-52 main.go: 第 07 行 到 第 08 行 

















_ "github.com/goinaction/code/chapter2/sample/matchers" 


"github.com/goinaction/code/chapter2/sample/search" 





main.go 代 码 文件 里 的 代码 并 没有 直接 使 用 任何 matchers 包 里 的 标 
识 符 。 不 过 ， 我 们 依旧 需要 编译 器 安排 调用 rss.go 代 码 文件 里 的 init 函 
数 。 在 第 07 行 ， 我 们 使 用 下 划 线 标识 符 作 为 别名 导入 matchers 包 ， 完 
成 了 这 个 调用 。 这 种 方法 可 以 让 编译 器 在 导入 未 被 引用 的 包 时 不 报错 ， 
而 且 依 旧 会 定位 到 包 内 的 init 函数 。 我 们 已 经 看 过 了 所 有 的 导入 、 类 
型 和 初始 化 函数 ， 现 在 来 看 看 最 后 两 个 用 于 实现 Matcher 接口 的 方法 ， 
如 代码 清单 2-53 所 示 。 





代码 清单 2-53 ”matchers/rss.go: 第 114 行 到 第 140 行 

















114 // retrieve 发 送 HTTP Get 请 求 获取 rss 数 据 源 并 解码 


115 func (m rssMatcher) retrieve(feed *search.Feed) (*rssDocument, error) 


{ 
































116 if feed.URI == "" { 

117 return nil, errors.New("No rss feed URI provided") 
118 } 

119 

126 // 从 网 络 获得 rss 数 据 源 文档 

121 resp, err := http.Get(feed.URI) 
122 if err != nil { 

123 return nil, err 

124 } 

125 

126 // 一 旦 从 函数 返回 ， 关 闭 返 回 的 响应 链接 
127 defer resp.Body.Close() 

128 


129 // 检查 状态 码 是 不 是 266， 这 样 就 能 知道 
136 // 是 不 是 收 到 了 正确 的 啊 应 








131 if resp.StatusCode != 260 { 

132 return nil, fmt.Errorf("HTTP Response Error %d\n", resp.Status 
Code) 

133 } 

134 

135 // 将 rss 数 据 源 文档 解码 到 我 们 定义 的 结构 类 型 是 
136 // 不 需要 检查 错误 ， 调 用 者 会 做 这 件 事 























下 


























137 var document rssDocument 

138 err = xml.NewDecoder(resp.Body).Decode(&document) 
139 return &document, err 

146 } 





方法 retrieve 并 没有 对 外 其 露 ， 其 执行 的 逻辑 是 从 RSS 数 据 源 的 





链接 拉 取 RSS 文 档 。 在 第 121 行 ， 可 以 看 到 调用 了 http 包 的 Get 方法 。 
我 们 会 在 第 8 章 进 一 步 介 绍 这 个 包 ， 现 在 只 需要 知道 ， 使 用 http 包 ，Go 
语言 可 以 很 容易 地 进行 网 络 请 求 。 当 Get 方法 返回 后 ， 我 们 可 以 得 到 一 
个 指向 Response 类 型 值 的 指针 。 之 后 会 监测 网 络 请 求 是 否 出 错 ， 并 在 
第 127 行 安排 函数 返回 时 调用 Close 方法 。 


在 第 131 行 ， 我 们 检测 了 Response 值 的 StatusCode 字段 ， 确 保 收 
到 的 响应 是 268 。 任 何不 是 266 的 请 求 都 需要 作为 错误 处 理 。 如 果 响 应 
值 不 是 286 ， 我 们 使 用 fmt 包 里 的 Errorf 函数 返回 一 个 自 定 义 的 错 
误 。 最 后 3 行 代 码 很 像 之 前 解码 JSON 数 据 文 件 的 代码 。 只 是 这 次 使 
用 xml 包 并 调用 了 同样 叫 作 NewDecoder 的 函数 。 这 个 函数 会 返回 一 个 
指 同 Decoder 值 的 指针 。 之 后 调用 这 个 指针 的 Decode 方法 ， 传 
入 rssDocument 类 型 的 局 部 变量 document 的 地 址 。 最 后 返回 这 个 局 部 
变量 的 地 址 和 Decode 方法 调用 返回 的 错误 值 。 


最 后 我 们 来 看 看 实现 了 Matcher 接口 的 方法 ， 如 代码 清单 2-54 所 





小 。 














代码 清单 2-54 ”matchers/rss.go: 第 69 行 到 第 112 行 





























69 // Search 在 文档 中 查找 特定 的 搜索 项 














76 func (m rssMatcher) Search(feed *search.Feed, searchTerm string) 
([]*search.Result，erro 


r){ 

71 var results [J]*search.Result 

72 

73 log.Printf("Search Feed Type[%s] Site[%s] For Uri[%s]\n", 


feed.Type, feed.Name, feed. 
































74 

75 // 获取 要 搜索 的 数据 

76 document, err := m.retrieve(feed) 

77 if err != nil { 

78 return nil, err 

79 } 

80 

81 for _, channelItem := range document.Channel.Item { 
82 // 检查 标题 部 分 是 否 包含 搜索 项 

83 matched, err := regexp.MatchString(searchTerm, channelItem.Tit 
le) 

84 if err != nil { 

85 return nil, err 

86 } 

87 

88 // 如 果 找 到 匹配 的 项 ， 将 其 作为 结果 保存 

89 if matched { 

90 results = append(results, &search.Result{ 
91 Field: "Title", 

92 Content: channelItem.Title, 

93 }) 

94 } 

95 

96 // 检查 描述 部 分 是 否 包含 搜 索 项 

97 matched, err = regexp.MatchString(searchTerm, channelItem.Desc 
ription) 

98 if err != nil { 

99 return nil, err 
166 } 
1061 
162 // 如 果 找 到 匹配 的 项 ， 将 其 作为 结果 保存 
163 if matched { 
164 results = append(results, &search.Result{ 
165 Field: "Description", 
166 Content : channelItem.Description, 
167 }) 
168 } 
169 } 
1106 
111 return results, nil 
112 } 





我 们 从 第 71 行 results 变量 的 声明 开始 分 析 ， 如 代码 清单 2-55 所 





示 。 这 个 变量 用 于 保存 并 人 返回 找到 的 结果 。 

















代码 清单 2-55 ”matchers/rss.go: 第 71 行 








71 var results [|]*search.Result 


我 们 使 用 关键 字 var 声明 了 一 个 值 为 nil 的 切片 ， 切 片 每 一 项 都 是 
指向 Result 类 型 值 的 指针 。Result 类 型 的 声明 在 之 前 match.go 代 码 文 
件 的 第 08 行 中 可 以 找到 。 之 后 在 第 76 行 ， 我 们 使 用 刚刚 看 过 的 
retrieve 方法 进行 网 络 调 用 ， 如 代码 清单 2-56 所 示 。 


代码 清单 2-56 ”matchers/rss.go: 第 75 行 到 第 79 行 





























// 获取 要 搜索 的 数据 
document, err := m.retrieve(feed) 
if err != nil { 


return nil, err 


} 





调用 retrieve 方法 返回 了 一 个 指 问 rssDocument 类 型 值 的 指针 以 
及 一 个 错误 值 。 之 后 ， 像 已 经 多 次 看 过 的 代码 一 样 ， 检 查 错 误 值 ， 如 果 
真 的 是 一 个 错误 ， 直 接 返 回 。 如 果 没 有 错误 发 生 ， 之 后 会 依次 检查 得 到 
的 RSS 文 档 的 每 一 项 的 标题 和 描述 ， 如 果 与 搜索 项 匹配 ， 就 将 其 作为 结 
果 保 存 ， 如 代码 清单 2-57 所 示 。 





代码 清单 2-57 matchers/rss.go: 第 81 行 到 第 86 行 








_， ChannelItem := range document.Channel.Item { 
// 检查 标题 部 分 是 否 包 含 搜索 项 
matched, err := regexp.MatchString(searchTerm, channelItem.Tit]l 























if err != nil { 
return nil, err 


} 





既然 document .Channel.Item 是 一 个 item 类 型 值 的 切片 ， 我 们 
在 第 81 行 对 其 使 用 for range 循环 ， 依 次 访问 其 内 部 的 每 一 项 。 在 第 83 
行 ， 我 们 使 用 regexp 包 里 的 Matchstring 函数 ， 对 channe1LItem 值 里 
的 Title 字段 进行 搜索 ， 玛 找 是 否 有 匹配 的 搜索 项 。 之 后 在 第 84 行 检查 
错误 。 如 果 没 有 错误 ， 束 会 在 第 89 行 到 第 94 行 检查 匹配 的 结果 ， 如 代码 














清单 2-58 所 示 。 





代码 清单 2-58 ”matchers/rss.go: 第 88 行 到 第 94 行 











// 如 果 找 到 匹配 的 项 ， 将 其 作为 结果 保存 
if matched { 
results = append(results, &search.Resultt{ 


Field: "Title", 
Content: channelItem.Title, 
}) 
} 





如 果 调 用 MatchSstring 方法 返回 的 matched 的 值 为 真 ， 我 们 使 用 
内 置 的 append 函数 ， 将 搜索 结果 加 入 到 results 切片 里 。append 这 个 
内 置 函 数 会 根据 切片 需要 ， 决 定 是 否 要 增加 切片 的 长 度 和 容量 。 我 们 会 
在 第 4 章 了 解 关 于 内 置 函数 append 的 更 多 知识 。 这 个 函数 的 第 一 个 参数 
是 希望 人 妃 加 到 的 切片 ， 第 二 个 参数 是 要 追加 的 值 。 在 这 个 例子 里 ， 追 加 
到 切片 的 值 是 一 个 指向 Result 类 型 值 的 指针 。 这 个 值 直 接 使 用 字面 声 
明 的 方式 ， 初 始 化 为 Result 类 型 的 值 。 之 后 使 用 取 地 址 运算 符 (& 
) ， 获 得 这 个 新 值 的 地 址 。 最 终 将 这 个 指针 存 入 了 切片 。 


在 检查 标题 是 否 匹 配 后 ， 第 97 行 到 第 108 行 使 用 同样 的 馆 辑 检 碍 
Description 字段 。 最 后 ， 在 第 111 行 ，Search 方法 返回 了 results 
作为 函数 调用 的 结果 。 





2.5 ”小 结 
每 个 代码 文件 都 属于 一 个 包 ， 而 包 名 应 该 与 代码 文件 所 在 的 文件 夹 


同 
Go 语言 提供 了 多 种 声明 和 初始 化 变量 的 方式 。 如 果 变 量 的 值 没 有 
显 式 初 始 化 ， 编 译 器 会 将 变量 初始 化 为 零 值 。 

使 用 指针 可 以 在 函数 间或 者 goroutine 间 共享 数据 。 

通过 启动 goroutine 和 使 用 通道 完成 并 发 和 同步 。 

Go 语言 提供 了 内 置 函 数 来 文 持 Go 语言 内 部 的 数据 结构 。 

。 标准 库 包含 很 多 包 ， 能 做 很 多 很 有 用 的 事情 。 

。 使 用 Go 接口 可 以 编写 通用 的 代码 和 框 染 。 











GD 这 个 说 法 并 不 严格 成 立 ，Go 标 准 库 中 的 io.Reader.Read 方 法 就 允许 同 
时 返回 数据 和 错误 。 但 是 ， 如 果 是 目 己 实现 的 函数 ， 要 尽量 遵守 这 个 原 
则 ， 保 持 含 义 足 够 明确 。 译 者 注 











第 3 草 打包 和 工具 链 
本 章 主要 内 容 


。 如 何 组 织 Go 代 码 

。 使 用 Go 语言 目 带 的 相关 命令 
。 使 用 其 他 开发 者 提供 的 工具 
。 与 其 他 开发 者 合作 


我 们 在 第 2 章 概 览 了 Go 语言 的 语法 和 语言 结构 。 本 章 会 进一步 介绍 
如 何 把 代码 组 织 成 色 ， 以 及 如 何 操作 这 些 包 。 在 Go 语言 里 ， 包 是 个 非 
常 重要 的 概念 。 其 设计 理念 是 使 用 包 来 封 效 不 同 语义 单元 的 功能 。 这 样 
做 ， 能 够 更 好 地 复 用 代码 ， 并 对 每 个 包 内 的 数据 的 使 用 有 更 好 的 控制 。 


在 进入 有 具体 细节 之 前 ， 假 设 读者 已 经 熟悉 命令 行 提 示 符 ， 或 者 操作 
系统 的 shell， 而 且 应 该 已 经 在 本 书 前 言 的 帮助 下 ， 安 装 了 Go。 如 果 上 面 
这 些 都 准备 好 了 ， 就 让 我 们 开始 进入 细节 ， 了 解 什么 是 包 ， 以 及 包 为 什 
么 对 Go 语言 的 生态 非常 重要 。 











3.1 包 


所 有 Go 语言 的 程序 都 会 组 织 成 耕 干 组 文件 ， 每 组 文件 被 称 为 一 个 
包 。 这 样 每 个 包 的 代码 都 可 以 作为 很 小 的 复 用 单元 ， 被 其 他 项 目 引 
用 。 让 我 们 看 看 标准 库 中 的 http 包 是 怎么 利用 包 的 特性 组 织 功能 的 : 


net/http/ 
cgi/ 
cookiejar/ 
testdata/ 
fcgi/ 


httptest/ 
httputil/ 
pprof/ 

testdata/ 





这 些 目录 包括 一 系列 以 .go 为 扩展 名 的 相关 文件 。 这 些 目录 将 实现 
HTTP 服 务 器 、 客 户 端 、 测 试 工具 和 性 能 调试 工具 的 相关 代码 拆 分 成 功 
能 清晰 的 、 小 的 代码 单元 。 以 cookiejar 包 为 例 ， 这 个 包 里 包含 与 存储 
和 获取 网 页 会 话 上 的 cookie 相 关 的 代码 。 每 个 包 都 可 以 单独 导入 和 使 
用 ， 以 便 开发 者 可 以 根据 自己 的 需要 导入 特定 功能 。 例 如 ， 如 果 要 实现 
HTTP 客 户 端 ， 只 需要 导入 http 包 就 可 以 。 


所 有 的 .go 文件 ， 除 了 空 行 和 注释 ， 都 应 该 在 第 一 行 声 明 上 自己 所 属 
的 包 。 每 个 包 都 在 一 个 单独 的 目录 里 。 不 能 把 多 个 包 放 到 同一 个 目录 
中 ， 也 不 能 把 同一 个 包 的 文件 分 拆 到 多 个 不 同 目录 中 。 这 意味 着 ， 同 一 
个 目录 下 的 所 有 .go 文件 必须 声明 同一 个 包 名 。 


3.1.1 包 名 惯例 


给 包 命 名 的 惯例 是 使 用 包 所 在 目录 的 名 字 。 这 让 用 户 在 导入 包 的 时 
候 ， 就 能 清晰 地 知道 包 名 。 我 们 继续 以 net/http 包 为 例 ， 在 http 目录 
下 的 所 有 文件 都 属于 http 包 。 给 包 及 其 目录 命名 时 ， 应 该 使 用 简洁 、 
清晰 且 全 小 写 的 名 字 ， 这 有 利于 开发 时 频繁 输入 包 名 。 例 
如 ，net/http 包 下 面 的 包 ， 如 cgi 、httputil 和 pprof ， 名 字 都 很 简 


VE 
1 日 o 























记 住 ， 并 不 需要 所 有 包 的 名 字 都 与 别 的 包 不 同 ， 因 为 导入 包 时 是 使 
用 全 路 径 的 ， 所 以 可 以 区 分 同名 的 不 同 包 。 一 般 情 况 下 ， 包 被 导入 后 会 
使 用 你 的 包 名 作为 默认 的 名 字 ， 不 过 这 个 导入 后 的 名 字 可 以 修改 。 这 个 
0 同 目录 的 同名 包 时 很 有 用 。3.2 节 会 展示 如 何 修 改 导 











3.1.2 main 包 


在 Go 语言 里 ， 命 名 为 main 的 包 具 有 特殊 的 含义 。Go 语 言 的 编译 程 
序 会 试图 把 这 种 名 字 的 包 编 译 为 二 进 制 可 执行 文件 。 所 有 用 Go 语言 编 
译 的 可 执行 程序 都 必须 有 一 个 名 叫 main 的 包 。 


当 编 译 器 发 现 某 个 包 的 名 字 为 main 时 ， 它 一 定 也 会 发 现 名 
为 main() 的 函数 ， 否 则 不 会 创建 可 执行 文件 。main() 函数 是 程序 的 入 
口 ， 所 以 ， 如 果 没 有 这 个 函数 ， 程 序 就 没有 办 法 开始 执行 。 程 序 编译 
时 ， 会 使 用 声明 main 包 的 代码 所 在 的 目录 的 目录 名 作为 二 进 制 可 执行 











文件 的 文件 名 。 


命令 和 包 Go 文档 里 经 党 使 用 命令 〈command) 这 个 词 来 指 
代 可 执行 程序 ， 如 命令 行 应 用 程序 。 这 会 让 新 手 在 阅读 文档 时 产生 
困惑 。 记 住 ， 在 Go 语言 里 ， 命 令 是 指 任何 可 执行 程序 。 作 为 对 
比 ， 包 更 常用 来 指 语义 上 可 导入 的 功能 单元 。 
让 我 们 来 实际 体验 一 下 。 首 先 ， 在 $4GOPATH/src/hello/ 目 录 里 创建 
一 个 叫 hello.go 的 文件 ， 并 输入 代码 清单 3-1 里 的 内 容 。 这 是 个 经 典 
的 “Hello World!” 程 序 ， 不 过 ， 注 意 一 下 包 的 声明 以 及 import 语句 。 


代码 清单 3-1 经 典 的 “Hello World!”* 程 序 














package main 


import "fmt" e fmt 包 提供 了 完成 格式 化 输出 的 功能 。 


func main() { 
fmt.Println("Hello World!") 
} 





获取 包 的 文档 ” 别 忘 了 ， 可 以 访问 http://golang.org/pkg/fmt/ 或 
者 在 终端 输入 godoc fmt 来 了 解 更 多 关于 fmt 包 的 细节 。 


保存 了 文件 后 ， 可 以 在 $GOPATH/src/hello/ 目 录 里 执行 命令 go 
build 。 这 条 命令 执行 完 后 ， 会 生成 一 个 二 进 制 文件 。 在 UNIX、Linux 
和 Mac OS X 系 统 上 ， 这 个 文件 会 命名 为 heallo， 而 在 Windows 系 统 上 会 命 
名 为 hello.exe。 可 以 执行 这 个 程序 ， 并 在 控制 台 上 显示 “Hello World!”。 


如 果 把 这 个 包 名 改 为 main 之 外 的 菜 个 名 字 ， 如 hello ， 纺 译 器 就 
认为 这 只 是 一 个 包 ， 而 不 是 命令 ， 如 代码 清单 3-2 所 示 。 


代码 清单 3-2 包含 main 函数 的 无 效 的 Go 程序 























61 package hello 
62 
83 import "fmt" 


04 

65 func main(){ 

66 fmt.Println("Hello, World!") 
67 } 





32 


我 们 已 经 了 解 如 何 把 代码 组 织 到 包 里 ， 现 在 让 我 们 来 看 看 如 何 导 入 
这 些 包 ， 以 便 可 以 访问 包 内 的 代码 。import 语句 告诉 编译 器 到 磁盘 的 
哪里 去 找 想 要 导入 的 包 。 导 入 包 需 要 使 用 关键 字 import ， 它 会 告诉 编 
译 器 你 想 引 用 该 位 置 的 包 内 的 代码 。 如 果 需 要 导入 多 个 包 ， 习 惯 上 是 
将 import 语句 包装 在 一 个 导入 块 中 ， 代 码 清单 3-3 展 示 了 一 个 例子 。 


代码 清单 3-3 import 声明 块 

















import ( 

"fmt" 

"strings" e strings 包 提供 了 很 多 关于 字符 串 的 操作 ， 如 查找 、 蔡 换 或 者 变换 
， 可 以 通过 访问 http://golang.org/pkg/strings/ 














或 者 在 终端 运行 godoc strings 来 了 解 更 多 关于 strings 包 的 细节 。 





编译 器 会 使 用 Go 环境 变量 设置 的 路 径 ， 通 过 引入 的 相对 路 径 来 查 
找 磁盘 上 的 包 。 标 准 库 中 的 包 会 在 安装 Go 的 位 置 找 到 。Go 开 发 者 创建 
的 包 会 在 GOPATH 环境 变量 指定 的 目录 里 查找 。GOPATH 指定 的 这 些 目录 
就 是 开发 者 的 个 人 工作 空间 。 


举 个 例子 。 如 果 Go 安 装 在 /usr/local/go， 并 且 环 境 变量 GOPATH 设置 
为 /home/myproject:/home/ mylibraries， 编 译 占 束 会 按照 下 面 的 顺序 查 
找 net/http 包 : 








/usr/local/go/src/pkg/net/http © 


这 就 是 标准 库 源 代码 所 在 的 位 置 。 








/home/myproject/src/net/http 


/home/mylibraries/src/net/http 


一 旦 编译 器 找到 一 个 满足 import 语句 的 包 ， 就 停止 进一步 查找 。 
有 一 件 重 要 的 事 需 要 记 住 ， 编 译 器 会 首先 查找 Go 的 安装 目录 ， 然 后 才 
会 按 顺 序 查 找 GOPATH 变量 里 列 出 的 目录 。 


如 果 编 译 器 查 衣 GOPATH 也 没有 找到 要 导入 的 包 ， 那 么 在 试图 对 程 
序 执行 run 或 者 build 的 时 候 束 会 出 错 。 本 章 后 面 会 介绍 如 何 通 过 go 
get 命令 来 修正 这 种 错误 。 














3.2.1 远程 导入 


目前 的 大 势 所 趋 是 ， 使 用 分 布 式 版 本 控制 系统 (Distributed Version 
Control Systems，DVCS) 来 分 享 代码 ， 如 GitHub、Launchpad 还 有 
Bitbucket。Go 语 言 的 工具 链 本 和 丑 束 广 持 从 这 些 网 站 及 类 似 网 站 获取 源 代 
码 。Go 工 具 链 会 使 用 导入 路 径 确 定 需 要 获取 的 代码 在 网 络 的 什么 地 
方 。 


例如 : 


import "github.com/spf13/viper" 


用 导入 路 径 编译 程序 时 ，go build 命令 会 使 用 GOPATH 的 设置 ， 在 
倒 盘 上 搜索 这 个 包 。 事 实 上， 这 个 导入 路 径 代 表 一 个 URL， 指 向 GitHub 
上 的 代码 库 。 如 果 路 径 包 含 URL， 可 以 使 用 Go 工具 链 从 DVCS 获 取 包 ， 
并 把 包 的 源 代 码 保 存在 GOPATH 指向 的 路 径 里 与 URL 匹 配 的 目录 里 。 这 
个 获取 过 程 使 用 go get 命令 完成 。go get 将 获取 任意 指定 的 URL 的 
包 ， 或 者 一 个 已 经 导入 的 包 所 依赖 的 其 他 包 。 由 于 go get 的 这 种 递归 
特性 ， 这 个 命令 会 扫描 某 个 包 的 源码 树 ， 获 取 能 找到 的 所 有 依赖 包 。 


3.2.2 ”命名 导入 
如 果 要 导入 的 多 个 包 具 有 相同 的 名 字 ， 会 发 生 什 么 ? 例如 ， 既 需要 


network/convert 包 来 转换 从 网 络 读 取 的 数据 ， 又 需要 file/convert 
包 来 转换 从 文本 文件 读 取 的 数据 时 ， 就 会 同时 导入 两 个 名 叫 convert 的 














包 。 这 种 情况 下 ， 重 名 的 包 可 以 通过 命名 导入 来 导入 。 命 名 导入 是 
指 ， 在 import 语句 给 出 的 包 路 径 的 左 侧 定义 一 个 名 字 ， 将 导入 的 包 命 
名 为 新 名 字 。 


例如 ， 知 用 户 已 经 使 用 了 标准 库 里 的 fmt 包 ， 现 在 要 导入 目 己 项 目 
里 名 叫 fmt 的 包 ， 就 可 以 通过 代码 清单 3-4 所 示 的 命名 导入 方式 ， 在 导 
入 时 重新 命名 目 己 的 包 。 























代码 清单 3-4 重 命名 导入 














61 package main 
02 
863 import ( 
"fmt" 
myfmt "mylib/fmt" 


68 func main() { 
fmt.Println("Standard Library") 
myfmt.Println("mylib/fmt") 





当 你 导入 了 一 个 不 在 代码 里 使 用 的 包 时 ，Go 编 译 器 会 编译 失败 ， 

并 输出 一 个 错误 。Go 开 发 团队 认为 ， 这 个 特性 可 以 防止 导入 了 未 被 使 
用 的 包 ， 吉 免 代 码 变 得 腑 肿 。 虽 然 这 个 特性 会 让 人 和 觉得 很 烦 ， 但 Go 开 
发 团队 仍然 伦 了 很 大 的 力气 说 服 上 自己， 决定 加 入 这 个 特性 ， 用 来 避免 其 
他 编程 语言 里 党 疝 遇 到 的 一 些 问题 ， 如 得 到 一 个 赛 满 未 使 用 库 的 超大 可 
执行 文件 。 很 多 语言 在 这 种 情况 会 使 用 警告 做 提示 ， 而 Go 开发 团队 认 
为 ， 与 其 让 编译 器 告 党 ， 不 如 和 直接 失败 更 有 意义 。 每 个 编译 过 大 型 C 程 
序 的 人 都 知道 ， 在 海 如 烟 海 的 编译 器 警告 里 找到 一 条 有 用 的 信息 是 多 么 
困难 的 一 件 事 。 这 种 情况 下 编译 失败 会 更 加 明确 。 


有 时， 用 户 可 能 需要 导入 一 个 包 ， 但 是 不 需要 引用 这 个 包 的 标识 
符 。 在 这 种 情况 ， 可 以 使 用 空白 标识 符 _ 来 重 命 名 这 个 导入 。 我 们 下 市 
会 讲 到 这 个 特性 的 用 法 。 

空白 标识 符 ”下划线 字符 (_ ) 在 Go 语言 里 称 为 空白 标识 


从 ， 有 很 多 用 法 。 这 个 标识 答 用 来 抛弃 不 想 继续 使 用 的 值 ， 如 给 导 
入 的 包 赋 予 一 个 空 名 字 ， 或 者 忽略 函数 返回 的 你 不 感 兴趣 的 值 。 

















3.3 ”函数 init 


每 个 包 可 以 包含 任意 多 个 init 函数 ， 这 些 函 数 都 会 在 程序 执行 开 
始 的 时 候 被 调用 。 所 有 被 编译 圳 发 现 的 init 函数 都 会 安排 在 main 函数 
之 前 执行 。init 函数 用 在 设置 包 、 初 始 化 变量 或 者 其 他 要 在 程序 运行 
前 优先 完成 的 引导 工作 。 


以 数据 库 驱 动 为 例 ，database 下 的 驱动 在 启动 时 执行 jnit 函数 会 
将 自身 注册 到 sql 包 里 ， 因 为 sql 包 在 编译 时 并 不 知道 这 些 驱 动 的 存 
在 ， 等 启动 之 后 sql 才能 调用 这 些 驱 动 。 让 我 们 看 看 这 个 过 程 中 init 
函数 做 了 什么 ， 如 代码 清单 3-5 所 示 。 














代码 清单 3-5 ini 函数 的 用 法 








61 package postgres 

62 

863 import ( 
"database/sql" 


67 func init() { 


08 sql.Register("postgres", new(PostgresDriver)) @ 创建 一 个 postg 
res 驱 动 的 实例 。 这 里 为 了 展现 init 的 作用 ， 没 有 展现 其 定义 细 市 。 


69 } 





这 上 段 示例 代码 包含 在 PostgreSQL 数 据 库 的 驱动 里 。 如 果 程 序 导入 了 
这 个 包 ， 束 会 调用 init 函数 ， 促 使 PostgreSQL 的 驱动 最 终 注册 到 Go 的 
sql 包 里 ， 成 为 一 个 可 用 的 驱动 。 


在 使 用 这 个 新 的 数据 库 驱 动 写 程序 时 ， 我 们 使 用 空白 标识 符 来 导入 
包 ， 以 便 新 的 驱动 会 包含 到 sql1 包 。 如 前 所 述 ， 不 能 导入 不 使 用 的 包 ， 
为 此 使 用 空白 标识 符 重 命名 这 个 导入 可 以 让 init 图 数 发 现 并 被 调度 运 
行 ， 证 编译 器 不 会 因为 包 未 和 被 使 用 而 产生 错误 。 


本 现在 我 们 可 以 调用 sql1.0pen 方法 来 使 用 这 个 驱动 ， 如 代码 清单 3-6 
二 


























代码 清单 3-6 ”导入 时 使 用 空白 标识 符 作 为 包 的 别名 








61 package main 

02 

863 import ( 

604 "database/sql" 

05 

66 _ "github.com/goinaction/code/chapter3/dbdriver/postgres" 
9 标识 符 导 入 包 ， 避 人 免 编译 错误 。 














69 func main() 
10 ”sql.0pen("postgres"，, "mydb") e。 一 一 调用 sql 包 提供 的 0pen 方 法 。 该 方法 
能 工作 的 关键 在 于 postgres 张 动 通过 自己 的 init 函 数 将 自身 注册 到 了 sql1 包 。 





11 } 





3.4 使 用 Go 的 工具 


在 前 几 音 里， 我 们 已 经 使 用 过 了 go 这 个 工具 ， 但 我 们 还 没有 探讨 
这 个 工具 都 能 做 哪些 事情 。 让 我 们 进一步 深入 了 解 这 个 短小 的 命令 ， 看 
看 都 有 哪些 强大 的 能 力 。 在 命令 行 提示 符 下 ， 不 市 参数 直接 键入 go 这 


个 命令 : 





$ go 


go 这 个 工具 提供 了 很 多 功能 ， 如 图 3-1 所 示 。 


The commands are: 


build 
CcLean 
doc 

env 

fix 

fmt 
generate 
get 
install 


compile packages and dependencies 

remove object files 

show documentation for package or Symbol 

print Go _ environment information 

run go tool fix on packages 

run gofmt on package Sources 

generate Go files by processing Source 
download and instaLL packages and dependencies 
compile and install packages and dependencies 


list list packages 

run compile and run Go program 
test test packages 

tool run specified go tool 
version print Go version 

vet run go tool vet on packages 


Use "go help [command]" for more information about a command. 
Additional help topics: 


C calling between Go and C 
buildmode description of build modes 
filetype file types 

gopath GOPATH environment variable 
importpath import path syntax 

packages description of package lists 
testflag [se[- of testing flLags 
testfunc description of testing functions 





Use "go help [topic]" for more information about that topic. 





图 3-1 ”go 命令 输出 的 帮助 文本 

通过 输出 的 列表 可 以 看 到 ， 这 个 命令 包含 一 个 编译 器 ， 这 个 编译 器 
可 以 通过 build 命令 启动 。 正 如 预料 的 那样 ，build 和 clean 命令 会 执 
行 编 译 和 清理 的 工作 。 现 在 使 用 代码 清单 3-2 里 的 源 代码 ， 尝 试 执行 这 


go build hello.go 


[L 


当 用 户 将 代码 签 入 源码 库 里 的 时 候 ， 开 发 人 员 可 能 并 不 想 签 入 编译 
生成 的 文件 。 可 以 用 clean 命令 解决 这 个 问题 : 


go _ clean hello.go 


调用 clean 后 会 删除 编译 生成 的 可 执行 文件 。 让 我 们 看 看 go 工具 
的 其 他 一 些 特 性 ， 以 及 使 用 这 些 命令 时 可 以 节省 时 间 的 方法 。 接 下 来 的 
例子 中 ， 我 们 会 使 用 代码 清单 3-7 中 的 样 例 代码 。 


代码 清单 3-7 ”使 用 io 包 的 工作 











package main 


import ( 
LL fmt 1 
"io/ioutil" 
"Os 1 


"github.com/goinaction/code/chapter3/words" 


) 
// main 是 应 用 程序 的 入 口 


func main() { 
filename := os.Args[1] 








contents, err := ioutil.ReadFile(filename) 
if err != nil { 

fmt.Println(err) 

return 


} 


text := string(contents) 


count := words.CountWords (text) 
fmt.Printf("There are %d words in your text. \n", count) 





如 有 果 已 经 下 载 了 本 书 的 源 代码 ， 应 该 可 以 在 
$GOPATH/src/github.com/goinaction/code/chapter3/words 找 到 这 个 包 。 确 





保 已 经 有 了 这 上段 代码 再 进行 后 面 的 内 容 。 


大 部 分 Go 工具 的 命令 都 会 接受 一 个 包 名 作为 参数 。 回 顾 一 下 已 经 
用 过 的 命令 ， 会 想起 build 命令 可 以 简写 。 在 不 包含 文件 名 时 ，go 工 
具 会 默认 使 用 当前 目录 来 编译 。 





go _ build 








因为 构建 包 是 很 常用 的 动作 ， 所 以 也 可 以 直接 指定 包 : 


go build github.com/goinaction/code/chapter3/wordcount 


也 可 以 在 指定 包 的 时 候 使 用 通配符 。3 个 点 表示 匹配 所 有 的 字符 
串 。 例 如 ， 下 面 的 命令 会 编译 chapter3 目录 下 的 所 有 包 : 


go build github.com/goinaction/code/chapter3/... 


除了 指定 包 ， 大 部 分 Go 命令 使 用 短路 径 作 为 参数 。 例 如 ， 下 面 两 
条 命令 的 效果 相同 : 


go build wordcount.go 











要 执行 程序 ， 需 要 首先 编译 ， 然 后 执行 编译 创建 的 wordcount 或 
者 wordcount .exe 程序 。 不 过 这 里 有 一 个 命令 可 以 在 一 次 调用 中 完成 
这 两 个 操作 : 


go run wordcount .go 


go_run 命令 会 先 构 建 wordcount.go 里 包含 的 程序 ， 然 后 执行 构建 后 
的 程序 。 这 样 可 以 节省 好 多 录入 工作 量 。 


做 开发 会 经 常 使 用 go build 和 go run 命令 。 让 我 们 看 另外 几 个 可 


用 的 命令 ， 以 及 这 些 命令 可 以 做 什么 。 


3.5 “进一步 介绍 Go 开发 工具 


我 们 已 经 学 到 如 何 用 go 这 个 通用 工具 进行 编译 和 执行 。 但 这 个 好 
用 的 工具 还 有 很 多 其 他 没有 介绍 的 诀 穹 。 





3.5.1 go vet 


这 个 命令 不 会 帮 开 发 人 员 写 代码 ， 但 如 果 开 发 人 员 已 经 写 了 一 些 代 
码 ，vet 命令 会 玫 开 及 人 员 检 测 代 码 的 第 见 错误 。 让 我 们 看 看 vet 捕获 
哪些 类 型 的 错误 。 


Printf 类 函数 调用 时 ， 类 型 匹配 错误 的 参数 。 

定义 常用 的 方法 时 ， 方 法 签名 的 错误 。 

错误 的 结构 标签 。 

没有 指定 字段 名 的 结构 字面 量 。 

让 我 们 看 看 许多 Go 开发 新 手 经 和 常 犯 的 一 个 错误 。fmt.Printf 函数 
常用 来 产生 格式 化 输出 ， 不 过 这 个 函数 要 求 开发 人 员 记 住所 有 不 同 的 格 
式 化 说 明 符 。 代 码 清 单 3-8 中 给 出 的 就 是 一 个 例子 。 


代码 清单 3-8 ”使 用 go vet 


















































61 package main 
02 


83 import "fmt" 
04 
65 func main() { 
fmt.Printf("The quick brown fox jumped over lazy dogs", 3.14) 





这 个 程序 要 输出 一 个 浮 点 数 3.14， 但 是 在 格式 化 字符 串 里 并 没有 对 
应 的 格式 化 参数 。 如 果 对 这 段 代 码 执行 go vet ， 会 得 到 如 下 消息 : 





go vet main.go 


main.go:6: no formatting directive in Printf call 


[L 


go vet 工具 不 能 让 开发 者 避免 严重 的 逻辑 错误 ， 或 者 避免 编写 充 
满 小 错 的 代码 。 不 过 ， 正 像 刚 才 的 实例 中 展示 的 那样 ， 这 个 工具 可 以 很 
好 地 捕获 一 部 分 常见 错误 。 每 次 对 代码 先 执行 go vet 再 将 其 签 入 源 代 
码 库 是 一 个 很 好 的 习惯 。 


3.5.2 ”Go 代码 格式 化 


fmt 是 Go 语言 社区 很 喜欢 的 一 个 命令 。fmt 工具 会 将 开 及 人 员 的 代 
码 布局 成 和 Go 源 代码 类 似 的 风格 ， 不 用 再 为 了 大 括 写 是 不 是 要 放 到 行 
尾 ， 或 者 用 tab〈 制 表 符 ) 还 是 空格 来 做 缩 进 而 争论 不 体 。 使 用 go fmt 
后 面 跟 文件 名 或 者 包 名 ， 束 可 以 调用 这 个 代码 格式 化 工具 。fmt 命令 会 
目 动 格式 化 开发 人 员 指 定 的 源 代 码 文件 并 保存 。 下 面 是 一 个 代码 执行 go 
fmt 前 和 执行 go fmt 后 几 行 代码 的 对 比 : 


if err != nil { return err } 


在 对 这 段 代 码 执行 go fmt 后 ， 会 得 到 : 














if err != nil { 
return err 


} 


很 多 Go 开发 人 员 会 配置 他 们 的 开发 环境 ， 在 保存 文件 或 者 提交 到 
代码 库 前 执行 go fmt 。 如 宋 读 者 喜欢 这 个 命令 ， 也 可 以 这 样 做 。 


3.5.3 ”Go 语言 的 文档 


还 有 另外 一 个 工具 能 让 Go 开发 过 程 变 简单 。Go 语 言 有 两 种 方法 为 
开发 者 生成 文档 。 如 果 开 发 人 员 使 用 命令 行 提示 符 工 作 ， 可 以 在 终端 上 
直接 使 用 go doc 命令 来 打印 文档 。 无 需 离开 终 闹 ， 即 可 快速 浏览 命令 
或 者 包 的 帮助 。 不 过 ， 如 果 开 友人 员 认 为 一 个 浏览 占 界 面 会 更 有 效率 ， 
可 以 使 用 godoc 程序 来 局 动 一 个 web 服务 器 ， 通 过 点 击 的 方式 来 查看 Go 
语言 的 包 的 文档 。Web 服 务 器 godoc 能 让 开发 人 员 以 网 页 的 方式 浏览 
己 的 系统 里 的 所 有 Go 语言 源 代码 的 文档 。 








1. 从 命令 行 获取 文档 

对 那 种 总 会 打开 一 个 终端 和 一 个 文本 编辑 器 (或 者 在 终 问 内 打开 文 
本 编辑 器 ) 的 开发 人 员 来 说 ，go doc 是 很 好 的 选择 。 假 设 要 用 Go 语言 
第 一 次 开发 读 取 UNIX tar 文件 的 应 用 程序 ， 想 要 看 看 archive/tar 包 
的 相关 文档 ， 就 可 以 输入 : 


执行 这 个 命令 会 直接 在 终端 产生 如 下 输出 : 
PACKAGE DOCUMENTATION 


package tar // import "archive/tar" 


Package tar implements access to tar archives. It aims to cover most of th 
e 
variations, including those produced by GNU and BSD tars. 


References: 


http://www.freebsd.org/cgi/man.cgi?query=tar&sektion=5 
http://www.gnu.org/software/tar/manual/html node/Standard.html 
http://pubs.opengroup.org/onlinepubs/9699919799/utilities/pax.html 


var ErrWriteTooLong = errors.New("archive/tar: write too long") ... 
var ErrHeader = errors.New("archive/tar: invalid tar header") 

func FileInfoHeader(fi os.FileInfo, link string) (*Header, error) 
func NewReader(r io.Reader) *Reader 

func NewWriter(w io.Writer) *Writer 

type Header struct { ... } 

type Reader struct { ... } 

type Writer struct { ... } 





开发 人 员 无 需 离 开 终 端 即 可 直接 翻 看 文档 ， 找 到 目 己 需要 的 部 分 。 


2. 浏览 文档 


Go 语言 的 文档 也 提供 了 浏览 器 版 本 。 有 了 时候 ， 通 过 跳 转 到 文档 ， 
查阅 相关 的 细 市 ， 能 更 容易 理解 整个 包 或 者 人 条 个 函数 。 在 这 种 情况 下 ， 
会 想 使 用 godoc 作为 Web 服 务 器 。 如 果 想 通过 Web 浏 览 器 查看 可 以 点 击 
跳 转 的 文档 ， 下 面 就 是 得 到 这 种 文档 的 好 方式 。 


开发 人 员 局 动 目 己 的 文档 服务 器 ， 只 需要 在 终端 会 话 中 输入 如 下 命 


令 ; 


godoc -http=:6666 


这 个 命令 通知 godoc 在 端口 6060 启 动 Web 服 务 器 。 如 果 浏 览 器 已 经 
打开 ， 导 航 到 http://localhost:6060 可 以 看 到 一 个 页 面 ， 包 含 所 有 Go 标准 
库 和 你 的 GOPATH 下 的 Go 源 代码 的 文档 。 


如 末 图 3-2 显 示 的 文档 对 开发 人 员 来 说 很 熟悉 ， 并 不 奇怪 ， 因 为 Go 
官网 就 是 通过 一 个 略微 修改 过 的 godoc 来 提供 文档 服务 的 。 要 进入 某 个 
特定 包 的 文档 ， 只 需要 点 击 页 面 顶端 的 Packages。 
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图 3-2 ”本 地 Go 文档 


Go 文档 工具 最 棒 的 地 方 在 于 ， 它 也 支持 开发 人 员 自 己 写 的 代码 。 
如 果 开 发 人 员 亲 从 一 个 简单 的 规则 来 写 代码 ， 这 些 代码 就 会 自动 包含 
在 godoc 生成 的 文档 里 。 


为 了 在 godoc 生成 的 文档 里 包含 自己 的 代码 文档 ， 开 发 人 员 震 要 用 
下 面 的 规则 来 写 代码 和 注释 。 我 们 不 会 在 本 章 介 绍 所 有 的 规则 ， 只 会 提 
一 些 重 要 的 规则 。 


用 户 需 要 在 标识 符 之 前 ， 把 自己 想 要 的 文档 作为 注释 加 入 到 代码 
中 。 这 个 规则 对 包 、 函 数 、 类 型 和 全 局 变量 都 适用 。 注 释 可 以 以 双 和 斜 线 
开头 ， 也 可 以 用 斜 线 和 星 写 风格 。 








// Retrieve 连 接 到 配置 库 ， 收 集 各 种 链接 设置 、 用 户 名 和 和 密码。 这 个 函数 在 成 功 时 


























// 返回 config 结 构 ， 否 则 返回 一 个 错误 。 
func Retrieve() (config, error) { 
.省 略 


// .. 








} 





在 这 个 例子 里 ， 我 们 展示 了 在 Go 语言 里 为 一 个 函数 写 文档 的 惯用 
方法 。 函 数 的 文档 下 接 写 在 函数 声明 之 前 ， 使 用 人 类 可 读 的 句子 编写 。 
如 末 想 给 包 写 一 段 文字 量 比较 大 的 文档 ， 可 以 在 工程 里 包含 一 个 叫 作 
doc.go 的 文件 ， 使 用 同样 的 包 名 ， 并 把 包 的 介绍 使 用 注释 加 在 包 名 声明 
之 且 。 


/* 























包 usb 提 供 了 用 于 调用 USB 设 备 的 类 型 和 函数 。 想 要 与 USB 设 备 创 建 一 个 新 链接 ， 使 用 New 


Connection 





并 A 
package usb 








这 段 关 于 包 的 文档 会 显示 在 所 有 类 型 和 函数 文档 之 前 。 这 个 例子 也 
展示 了 如 何 使 用 矢 线 和 星 号 做 注释 。 可 以 在 Google 上 搜索 golang 
documentation 来 查找 更 多 关于 如 何 给 代码 创建 一 个 好 文档 的 内 容 。 

3.6 与 其 他 Go 开发 者 合作 

现代 开发 者 不 会 一 个 人 单打 独 斗 ， 而 Go 工具 也 认可 这 个 趋势 ， 并 
为 合作 提供 了 文 持 。 多 亏 了 go 工具 链 ， 包 的 概念 没有 被 限制 在 本 地 开 
发 环境 中 ， 而 是 做 了 扩展 ， 从 而 文 持 现代 合作 方式 。 让 我 们 看 看 在 分 布 
式 开发 环境 里 ， 想 要 民 好 合作 ， 需 要 遵守 的 一 些 惯 例 。 

以 分 享 为 目的 创建 代码 库 


开发 人 员 一 旦 写 了 些 非常 棒 的 Go 代码 ， 就 会 很 想 把 这 些 代 码 与 Go 
社区 的 其 他 人 分 诗 。 这 其 实 很 容易 ， 只 需要 执行 下 面 的 步 又 束 可 以 。 


1. 包 应 该 在 代码 库 的 根 目录 中 
使 用 go get 的 时 候 ， 开 发 人 员 指 定 了 要 导入 包 的 全 路 径 。 这 意味 














着 在 创建 想 要 分 享 的 代码 库 的 时 候 ， 包 名 应 该 就 是 代码 库 的 名 字 ， 而 且 
包 的 源 代码 应 该 位 于 代码 库 目 录 结 构 的 根 目录 。 


Go 语言 新 手 常 犯 的 一 个 错误 是 ， 在 公用 代码 库 里 创建 一 个 名 
为 code 或 者 src 的 目录 。 如 果 这 人 么 做 ， 会 让 导入 公用 库 的 语句 变 得 很 
0 只 需要 把 包 的 源 文件 放 在 公用 代码 库 的 根 目 
录 刺 好 。 


2. 包 可 以 非常 小 


与 其 他 语言 相 比 ，Go 语 言 的 包 一 般 相 对 较 小 。 不 要 在 意 包 只 支持 
几 个 API， 或 者 只 完成 一 项 任务 。 在 Go 语言 里 ， 这 样 的 包 很 常见 ， 而 且 
很 受 欢 迎 。 


3.， 对 代码 执行 go fmt 


和 其 他 开源 代码 库 一 样 ， 人 们 在 试用 代码 前 会 通过 源 代码 来 判断 代 
码 的 质量 。 开 发 人 员 需 要 在 签 入 代码 前 执行 go fmt ， 这 样 能 让 目 己 的 
代码 可 读 性 更 好 ， 而 且 不 会 由 于 一 些 字符 的 干扰 (如 制 表 符 〉，， 在 不 同 
人 的 计算 机 上 代码 显示 的 效果 不 一 样 。 


4. 给 代码 写 文 档 


Go 开发 者 用 godoc 来 阅读 文档 ， 并 且 会 用 http://godoc.org 这 个 网 站 
来 阅读 开源 包 的 文档 。 如 果 按 照 go doc 的 最 佳 实践 来 给 代码 写 文档 ， 
包 的 文档 在 本 地 和 线 上 都 会 很 好 看 ， 更 容易 被 别人 发 现 。 


3.7 ”依赖 管理 


从 Go 1.0 发 布 那天 起 ， 社 区 做 了 很 多 努力 ， 提 供 各 种 Go 工具 ， 以 便 
开发 人 员 的 工作 更 轻松 。 有 很 多 工具 专注 在 如 何 管理 包 的 依赖 关系 。 现 
在 最 流行 的 依赖 管理 工具 是 Keith Rarik 写 的 godep、Daniel Theophanes 写 
的 vender 和 Gustavo Niemeyer 开 发 的 gopkg.in 工 具 。gopkg.in 能 帮助 开发 
人 员 发 布 自己 的 包 的 多 个 版 本 。 


作为 对 社区 的 回应 ，Go 语 言 在 1.5 版 本 开始 试验 性 提供 一 组 新 的 构 
建 选项 和 功能 ， 来 为 依赖 管理 提供 更 好 的 工具 文 持 。 尺 管 我 们 还 需要 等 
一 段 时 间 才 能 确认 这 些 新 特性 是 否 能 达成 目的 ， 但 毕竟 现在 已 经 有 一 些 





























工具 以 可 重复 使 用 的 方式 提供 了 管理 、 构 建 和 测试 Go 代码 的 能 力 。 
3.7.1 第 三 方 依赖 


像 godep 和 vender 这 种 社区 工具 已 经 使 用 第 三 方 (verdoring) 导入 
路 径 重 写 这 种 特性 解决 了 依赖 问题 。 其 思想 是 把 所 有 的 依赖 包 复 制 到 工 
os 的 目录 里 ， 然 后 使 用 工程 内 部 的 依赖 包 所 在 目录 来 重 写 所 有 
和 导入 路 径 。 


代码 清单 3-9 展 示 的 是 使 用 godep 来 管理 工程 里 第 三 方 依赖 时 的 一 个 
典型 的 源 代 码 树 。 














代码 清单 3-9 ”使 用 godep 的 工程 


$GOPATH/src/github.com/ardanstudios/myproject 
|-- Godeps 
|-- Godeps.json 
|-- Readme 
|-- _workspace 
|-- src 
-- bitbucket.org 


|-- goautoneg 
|-- Makefile 
|-- README .txt 
|-- autoneg.go 
|-- autoneg test.go 
-- github.com 
|-- beorn7 


|-- README.md 
|-- quantile 
|-- bench test.go 


|-- example_test.go 
|-- exampledata.txt 
|-- stream.go 


examples 
model 
README .md 
main.go 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| |-- perks 
| 

| 

| 

| 

| 

| 

| 
|-- 
|-- 
|-- 
|-- 





可 以 看 到 godep 创建 了 一 个 叫 作 Godeps 的 目录 。 由 这 个 工具 管理 
的 依赖 的 源 代码 被 放 在 一 个 叫 作 _workspace/src 的 目录 里 。 


接 下 来 ， 如 果 看 一 下 在 main.go 里 声明 这 些 依 赖 的 ijmport 语句 (如 
代码 清单 3-9 和 代码 清单 3-10 所 示 ) ， 就 能 发 现 需要 改动 的 地 方 。 


代码 清单 3-10 ”在 路 径 重 写 之 前 




















61 package main 
02 
863 import ( 


"bitbucket.org/ww/goautoneg" 
"github.com/beorn7/perks" 














代码 清单 3-11 在 路 径 重 写 之 后 

















61 package main 

02 

863 import ( 

604 "github.ardanstudios.com/myproject/Godeps/_ workspace/src/ 


bitbucket .org/ww/goautoneg" 
"github.ardanstudios.com/myproject/Godeps/_ workspace/src/ 
github.com/beorn7/perks" 





在 路 径 重 写 之 前 ，import 语句 使 用 的 是 包 的 正常 路 径 。 包 对 应 的 
代码 存放 在 GOPATH 所 指定 的 磁盘 目录 里 。 在 依赖 管理 之 后 ， 导 入 路 径 
的 路 径 。 可 以 看 到 这 些 导入 路 径 非 常 长 ， 不 

ME 全 


引入 依赖 管理 将 所 有 构建 时 依赖 的 源 代 码 都 导入 到 一 个 单独 的 工程 
代码 库 里 ， 可 以 更 容易 地 重新 构建 工程 。 使 用 导入 路 径 重 写 管 理 依赖 包 
的 另外 一 个 好 处 是 这 个 工程 依旧 文 持 通过 go get 获取 代码 库 。 当 获取 
ee go get 可 以 找到 每 个 包 ， 并 将 其 保存 到 工程 里 
确 的 目录 中 。 


3.7.2 ”对 gb 的 介绍 





外 是 一 个 由 Go 社区 成 员 开 发 的 全 新 的 构建 工具 。gb 意 识 到 ， 不 一 
定 要 包装 Go 本 身 的 工具 ， 也 可 以 使 用 其 他 方法 来 解决 可 重复 构建 的 问 


匮 。 


gb 背后 的 原理 源 自理 解 到 Go 语言 的 jmport 语句 并 没有 提供 可 重复 
构建 的 能 力 。import 语句 可 以 驱动 go get ， 但 是 import 本 身 并 没有 
包含 足够 的 信息 来 决定 到 底 要 获取 包 的 哪个 修改 的 版 本 。go get 无 法 
定位 待 获 取代 码 的 问题 ， 导 致 Go 工具 在 解决 重复 构建 时 ， 不 得 不 使 用 
I 我 们 已 经 看 到 过 使 用 godep 时 超 长 的 导入 路 径 是 多 
入 难看 


g 凶 的 创建 源 于 上 述 理解 。gb 既 不 包装 Go 工具 链 ， 也 不 使 用 GOPATH 
。 趣 基于 工程 将 Go 工具 链 工 作 空 间 的 元 信息 做 蔡 换 。 这 种 依赖 管理 的 
方法 不 需要 重 写 工程 内 代码 的 导入 路 径 。 而 且 导 入 路 径 依旧 通过 go 
get 和 GOPATH 工作 空间 来 管理 。 


”让 我 们 看 看 上 一 市 的 工程 如 何 转换 为 gb 工程 ， 如 代码 清单 3-12 所 
示 。 

















代码 清单 3-12 gb 工程 的 例子 











/home/bill/devel/myproject ($PROJECT) 
|-- src 
|-- cmd 
| |-- myproject 
| |-- main.go 
|-- examples 
|-- model 
|-- README.md 
- vendor 
|-- src 
|-- bitbucket.org 
|-- ww 
|-- goautoneg 
- Makefile 
- _ README .txt 
- autoneg.go 
- autoneg test.go 
- github.com 
|-- beorn7 

|-- perks 

|-- README .md 

|-- quantile 


| -- bench test.go 
|-- example test.go 
|-- exampledata.txt 
|-- stream.go 








一 个 gb 工程 就 是 磁盘 上 一 个 包含 src/ 子 目 录 的 目录 。 符 号 








$PROJECT 导入 了 工程 的 根 目录 中 ， 其 下 有 一 个 src/ 的 子 目 录 中 。 这 个 
符号 只 是 一 个 简写 ， 用 来 描述 工程 在 磁盘 上 的 位 置 。$PROJECT 不 是 必 
须 设置 的 环境 变量 。 事 实 上 ，gb 根 本 不 需要 设置 任何 环境 变量 。 


gb 工程 会 区 分 开发 人 员 写 的 代码 和 开发 人 员 需 要 依赖 的 代码 。 开 发 
人 员 的 代码 所 依赖 的 代码 被 称 作 第 三 方 代码 (vendored code) 。gb 工 
人 的 代码 和 第 三 方 代码 ， 如 代码 清单 3-13 和 代码 清 
3-14 有 所 不 。 























代码 清单 3-13 ”工程 中 存放 开发 人 员 写 的 代码 的 位 置 


$PROJECT/ src/ 


代码 清单 3-14 ”存放 第 三 方 代码 的 位 置 


$PROJECT/vendor/src/ 


gb 一 个 最 好 的 特点 是 ， 不 需要 重 写 导入 路 径 。 可 以 看 看 这 个 工程 
里 的 main.go 文 件 的 ijmport 语句 没有 任何 需要 为 导入 第 三 方 库 而 做 
的 修改 ， 如 代码 清单 3-15 所 示 。 












































代码 清单 3-15 ”gb 工程 的 导入 路 径 














61 package main 

02 

863 import ( 
"bitbucket.org/ww/goautoneg" 


"github.com/beorn7/perks" 





外 工具 首先 会 在 $PROJECT/src/ 目录 中 碍 找 代 码 ， 如 果 找 不 到 ， 


会 在 $PROJECT/vender/src/ 目录 里 查找 。 与 工程 相关 的 整个 源 代 码 
都 会 在 同一 个 代码 库 里 。 自 己 写 的 代码 在 工程 目录 的 src/ 目录 中 ， 第 
三 方 依 赖 代码 在 工程 目录 的 vender/src 子 目 录 中 。 这 样 ， 不 需要 配合 
重 写 导 入 路 径 也 可 以 完成 整个 构建 过 程 ， 同 时 可 以 把 整个 工程 放 到 磁盘 
的 任意 位 置 。 这 些 特点 ， 让 gb 成 为 社区 里 解决 可 重复 构建 的 流行 工具 。 


还 需要 提 一 点 : gb 工程 与 Go 官方 工具 链 (包括 go get ) 并 不 兼 
。 因 为 gb 不 需要 设置 GOPATH ， 而 Go 工具 链 无 法 理解 gb 工程 的 目录 结 
向 所 以 无 法 用 Go 工具 链 构 建 、 测 试 或 者 获取 代码 。 构 建 〈 如 代码 清 


单 3-16 所 示 ) 和 测试 gb 工程 需要 先进 入 $PROJECT 目录 ， 并 使 用 gb 工 
上 Ri 


"wo 























代码 清单 3-16 ”构建 gb 工程 


gb build all 


很 多 Go 工具 文 持 的 特性 ，gb 都 提供 对 应 的 特性 。gb 还 提供 了 插件 
系统 ， 可 以 让 社区 扩展 支持 的 功能 。 其 中 一 个 插件 叫 作 vender 。 这 个 
插件 可 以 方便 地 管理 $PROJECT/vender/src/ 目录 里 的 依赖 关系， 而 
这 个 功能 Go 工具 链 至 今 没 有 提供 。 想 了 解 更 多 gb 的 特性 ， 可 以 访问 这 
个 网 站 : getgb.io。 

















3.8 “小结 


@ 年 Go 语言 中 包 是 组 织 代码 的 基本 单位 。 

。 0 决定 了 Go 源 代码 在 磁盘 上 被 保存 、 编 译 和 安装 的 
立 置 

0 同 的 GOPATH ， 以 保持 源 代码 和 依赖 的 隔 





,定夺 是 在 命令 行 上 工作 的 最 好 工具 。 

e。 开发 人 员 可 以 使 用 go get 来 获取 别人 的 包 并 将 其 安装 到 自己 的 
GOPATH 指定 的 目录 。 

。 想 要 为 别人 创建 包 很 简单 ， 只 要 把 源 代码 放 到 公用 代码 库 ， 并 遵守 

一 些 简单 规则 就 可 以 了 。 

Go 语言 在 设计 时 将 分 享 代 码 作为 语言 的 核心 特性 和 驱动 力 。 

。 推荐 使 用 依赖 管理 工具 来 管理 依赖 。 





。 有 很 多 社区 开发 的 依赖 管理 工具 ， 如 godep、vender 和 gb。 


第 4 章 ” 数 组 、 切 片 和 映射 
本 章 主要 内 容 


。 数组 的 内 部 实现 和 基础 功能 
。 使 用 切片 管理 数据 集合 
。 使 用 映射 管理 键 值 对 


很 难 遇 到 要 编写 一 个 不 需要 存储 和 读 取 集合 数据 的 程序 的 情况 。 如 
果 使 用 数据 库 或 者 文件 ， 或 者 访问 网 络 ， 总 需要 一 种 方法 来 处 理 接收 和 
发 送 的 数据 。Go 语 言 有 3 种 数据 结构 可 以 让 用 户 管理 集合 数据 : 数组 、 
切片 和 映射 。 这 3 种 数据 结构 是 语言 核心 的 一 部 分 ， 在 标准 库 里 被 广泛 
使 用 。 一 旦 学 会 如 何 使 用 这 些 数据 结构 ， 用 Go 语言 编写 程序 会 变 得 快 
速 、 有 趣 且 十 分 灵活 。 


4.1 数组 的 内 部 实现 和 基础 功能 


了 解 这 些 数据 结构 ， 一 般 会 从 数组 开始 ， 因 为 数组 是 切片 和 映射 的 
基础 数据 结构 。 理 解 了 数组 的 工作 原理 ， 有 助 于 理解 切片 和 映射 提供 的 
优雅 和 强大 的 功能 。 


4.1.1 内 部 实现 


在 Go 语言 里 ， 数 组 是 一 个 长 度 回 定 的 数据 类 型 ， 用 于 存储 一 段 具 
有 相同 的 类 型 的 元 素 的 连续 块 。 数 组 存储 的 类 型 可 以 是 内 置 类 型 ， 如 整 
型 或 者 字符 串 ， 也 可 以 是 菜 种 结构 类 型 。 


在 图 4-1 中 可 以 看 到 数组 的 表示 。 灰 色 格子 代表 数组 里 的 元 素 ， 每 
个 元 素 部 紧邻 男 一 个 元 素 。 每 个 元 系 包 含 相同 的 类 型 ， 这 个 例子 里 是 整 
数 ， 并 且 每 个 元 系 可 以 用 一 个 唯一 的 索引 《也 称 下 标 或 标号 ) 来 访问 。 














整数 整数 整数 整数 


图 4-1 数组 的 内 部 实现 








数组 是 一 种 非常 有 用 的 数据 结构 ， 因 为 其 占用 的 内 存 是 连续 分 配 
的 。 由 于 内 存 连续 ，CPU 能 把 正在 使 用 的 数据 缓存 更 久 的 时 间 。 而 且 凡 
存 连续 很 容易 计算 索引 ， 可 以 快速 迭代 数组 里 的 所 有 元 素 。 数 组 的 类 型 
信息 可 以 提供 每 次 访问 一 个 元 素 时 需要 在 内 存 中 移动 的 距离 。 既 然 数 组 
的 每 个 元 和 素 类 型 相同 ， 又 是 连续 分 配 ， 王 可 以 以 固定 速度 索引 数组 中 的 
任意 数据 ， 速 度 非常 快 。 


4.1.2 ”声明 和 初始 化 


声明 数组 时 需要 指定 内 部 存储 的 数据 的 类 型 ， 以 及 需要 存储 的 元 素 
的 数量 ， 这 个 数量 也 称 为 数组 的 长 度 ， 如 代码 清单 4-1 所 示 。 


4-1 声明 一 个 数组 ， 并 设置 为 零 值 























代码 清 




















// 声明 一 个 包含 5 个 元 素 的 整 型 数组 


var array [5]int 





一 旦 声明 ， 数 组 里 存储 的 数据 类 型 和 数组 长 度 就 都 不 能 改变 了 。 如 
果 需 要 存储 更 多 的 元 素 ， 就 需要 先 创建 一 个 更 长 的 数组 ， 再 把 原来 数组 
里 的 值 复制 到 新 数组 里 。 


在 Go 语言 中 声明 变量 时 ， 总 会 使 用 对 应 类 型 的 零 值 来 对 变量 进行 
初始 化 。 数 组 也 不 例外 。 当 数组 初始 化 时 ， 数 组 内 每 个 元 系 部 初始 化 为 
对 应 类 型 的 零 值 。 在 图 4-2 里 ， 可 以 看 到 整 型 数组 里 的 每 个 元 系 部 初始 
化 为 0， 也 就 是 整 型 的 零 值 。 











[0 ] [1] [2] [3 ] [4] 
0 0 0 0 0 
图 4-2 声明 数组 变量 后 数组 的 什 
一 种 快速 创建 数组 并 初始 化 的 方式 是 使 用 数组 字面 量 。 数 组 字面 量 


允许 声明 数组 里 元 系 的 数量 同时 指定 每 个 元 素 的 值 ， 如 代码 清单 4-2 所 
外。 



































代码 清单 42 ”使 用 数组 字面 量 声明 数组 





























// 声明 一 个 包含 5 个 元 素 的 整 型 数组 
// 用 具体 值 初始 化 每 个 元 素 
array := [5]int{16，26，36，46，56} 


























如 果 使 用 . .. 蔡 代 数组 的 长 度 ，Go 语言 会 根据 初始 化 时 数组 元 素 
的 数量 来 确定 该 数组 的 长 度 ， 如 代码 清单 43 所 示 。 


代码 清单 4-3 ”让 Go 自动 计算 声明 数组 的 长 度 


























// 声明 一 个 整 型 数组 

// 用 具体 值 初始 化 每 个 元 素 

// 容量 由 初始 化 值 的 数量 决定 

array := [...]int{106, 206, 36, 40，506} 


















































如 果 知 道 数组 的 长 度 而 是 准备 给 每 个 值 都 指定 具体 值 ， 就 可 以 使 用 
代码 清单 4-4 所 示 的 这 种 语法 。 
































代码 清单 4-4 声明 数组 并 指定 特定 元 素 的 值 














// 声明 一 个 有 5 个 元 素 的 数组 
// 用 其 体 值 初始 化 索引 为 1 和 2 的 元 素 
// 其 余 元 素 保持 零 值 



































array := [5]int{1: 16，2: 206} 





[0 1] 史册 [21] [3] [41 
0 10 20 0 0 
| 


图 4-3 ”声明 之 后 数组 的 值 


_ 代码 清单 4-4 中 声明 的 数组 在 声明 和 初始 化 后 ， 会 和 图 4-3 所 展现 的 




















4.1.3 ”使 用 数组 


正 像 之 前 提 到 的 ， 因 为 内 存 布局 是 连续 的 ， 所 以 数组 是 效率 很 高 的 
数据 结构 。 在 访问 数组 里 任意 元 素 的 时 候 ， 这 种 高 效 都 是 数组 的 优势 。 
要 访 问 数组 里 茶 个 单独 元 素 ， 使 用 [] 运算 符 ， 如 代码 清单 4-5 所 示 。 


代码 清单 4-5 访问 数组 元 素 



































// 声明 一 个 包含 5 个 元 素 的 整 型 数组 
// 用 具体 值 初始 为 每 个 元 素 
array := [5]int{16，26，36，46，56} 























// 修改 索引 为 2 的 元 素 的 值 
array[2] = 35 





_ 代码 清单 4-5 中 声明 的 数组 的 值 在 操作 完成 后 ， 会 和 图 4-4 所 展现 的 


[0 ] [1] [2] [3] [4] 
10 20 35 40 50 


图 4-4 ”修改 索引 为 2 的 值 之 后 数组 的 值 




















可 以 像 第 2 章 一 样 ， 声 明 一 个 所 有 元 素 都 是 指针 的 数组 。 使 用 * 运 
算 符 就 可 以 访问 元 素 指针 所 指向 的 值 ， 如 代码 清单 4.6 所 示 。 





代码 清单 4-6 访问 指针 数组 的 元 素 


// 声明 包含 5 个 元 素 的 指向 整数 的 数组 
// 用 整 型 指针 初始 化 索引 为 8 和 1 的 数组 元 素 
array := [5]*int{t6: new(int), 1: new(int)} 


// 为 索引 为 68 和 1 的 元 素 赋值 
*xarray[6] = 16 
*array[1] = 26 





_ 代码 清单 4-6 中 声明 的 数组 的 值 在 操作 完事 后 ， 会 和 图 4-5 所 展现 的 


O 


[0] [11 [2] [3] [41 
地 址 地 址 地 址 地 址 地 址 
有 向 整 型 的 指针 | 指向 整 型 的 指针 | 指向 整 型 的 指针 | 指向 整 型 的 指针 | 指向 整 型 的 指针 


图 4-5 ”指向 整数 的 指针 数组 


在 Go 语言 里 ， 数 组 是 一 个 值 。 这 意味 着 数组 可 以 用 在 赋值 操作 
中 。 变 量 名 代表 整个 数组 ， 因 此 ， 同 样 类 型 的 数组 可 以 赋值 给 男 一 个 数 
组 ， 如 代码 清单 4-7 所 示 。 



































代码 清单 47 把 同样 类 型 的 一 个 数组 赋值 给 另外 一 个 数组 














// 声明 第 一 个 包含 5 个 元 素 的 字符 串 数 组 
var array1 [5]string 


// 声明 第 二 个 包含 5 个 元 素 的 字符 串 数 组 
// 用 颜色 初始 化 数组 
array2 := [5]jstring{"Red", "Blue", "Green", "Yellow", "Pink"} 





// 把 array2 的 值 复制 到 array1 
arrayl1 = array2 





复制 之 后 ， 两 个 数组 的 值 完全 一 样 ， 如 图 4-6 所 示 。 


[0] [1] [2] [3] [4] 
Red Blue Green Yellow Pink 
字符 串 字符 串 字符 串 字符 串 字符 串 
[1] 


[0] [2] [3] [4] 


Red Blue Green Yellow Pink 
字符 串 字符 串 字符 串 字符 串 字符 串 


图 4-6 ”复制 之 后 的 两 个 数组 


数组 变量 的 类 型 包括 数组 长 度 和 每 个 元 系 的 类 型 。 只 有 这 两 部 分 都 
相同 的 数组 ， 才 是 类 型 相同 的 数组 ， 才 能 互相 赋值 ， 如 代码 清单 4-8 所 
外。 























代码 清单 4-8 ”编译 器 会 阻止 类 型 不 同 的 数组 互相 赋值 


// 声明 第 一 个 包含 4 个 元 素 的 字符 串 数 组 
var array1 [4]string 


// 声明 第 二 个 包含 5 个 元 素 的 字符 串 数 组 
// 使 用 颜色 初始 化 数组 
array2 := [5]jstring{"Red", "Blue", "Green", "Yellow", "Pink"} 





// 将 array2 复 制 给 array1 
arrayl1 = array2 


Compiler Error: 
cannot use array2 (type [5]string) as type [4]string in assignment 





复制 数组 指针 ， 只 会 复制 指针 的 值 ， 而 不 会 复制 指针 所 指向 的 值 ， 
如 代码 清单 4-9 所 示 。 




















代码 清 








4-9 ”把 一 个 指针 数组 赋值 给 为 一 个 


0 











// 声明 第 一 个 包含 3 个 元 素 的 指向 字符 串 的 指针 数组 


var array1 [3]*string 





// 声明 第 二 个 包含 3 个 元 素 的 指向 字符 串 的 指针 数组 
// 使 用 字符 串 指针 初始 化 这 个 数组 


array2 := [3]*string{new(string), new(string), new(string)} 























// 使 用 颜色 为 每 个 元 素 赋 值 


*xaprray2[6] = "Red" 
*array2[1] = "Blue" 
*array2[2] = "Green" 





// 将 array2 复 制 给 array1 
arrayl1 = array2 





复制 之 后 ， 两 个 数组 指向 同一 组 字符 串 ， 如 图 4-7 所 示 。 


哪 和 [2] 
地 址 地 址 地 址 
指向 字符 串 的 指针 | 指向 字符 串 的 指针 | 指向 字符 串 的 指针 


地 址 地 址 地 址 
指向 字符 串 的 指针 | 指向 字符 串 的 指针 | 指向 字符 串 的 指针 
L141] 


图 4-7 ”两 组 指向 同样 字符 串 的 数组 




















4.1.4 多 维 数组 


数组 本 喘 只 有 一 个 维度 ， 不 过 可 以 组 合 多 个 数组 创建 多 维 数组 。 多 
维 数 组 很 容易 管理 具有 父子 关系 的 数据 或 者 与 坐标 系 相 关联 的 数据 。 声 
明 二 维 数组 的 示例 如 代码 清单 4-10 所 示 。 














代码 清单 4-10 ”声明 二 维 数组 

















// 声明 一 个 二 维 整 型 数组 ， 两 个 维度 分 别 存 储 4 个 元 素 和 2 个 元 素 








var array [4][2]int 














// 使 用 数组 字面 量 来 声明 并 初始 化 一 个 二 维 整 型 数组 
array := [4][2]int{{16, 11}, {20, 21}, {36, 31}, {46, 41}} 


























// 声明 并 初始 化 外 层 数组 中 索引 为 1 个 和 3 的 元 素 





array := [4][2]int{f1: {26, 21}, 3: {406, 41}} 


// 声明 并 初始 化 外 层 数组 和 内 层 数 组 的 单个 元 素 
array := [4][2]int{f1: {6: 26}, 3: {1: 41}} 








ee 了 代码 清单 4-10 中 声明 的 二 维 数组 在 每 次 声明 并 初始 化 后 


[和 [2] [3] 


[0] 
整 型 数组 整 型 数组 整 型 数组 整 型 数组 


[4] (211mEA 人 10, lls {20, 2L}, {80 3L}y, M0 4L}} 


[0 ] [1] [2] [3] 
整 型 数组 整 型 数组 ee 整 型 数组 


array gs LE4]J [21]12nt{1s (20 训 Ly; Bi GCAO 13 


[0] [1] [2] [3] 
EE | atl 
[oT] 整 型 数组 oe 整 型 数组 


array: se [4] 12]1int{1s {0: 20}), 3: {Lx WL}y 











图 4-8 二 维 数组 及 其 外 层 数 组 和 内 层 数 组 的 值 


人 需要 反复 组 合 使 用 [] 运算 符 ， 如 代码 清单 4-11 
不 。 























代码 清单 4-11 访问 二 维 数组 的 元 素 


// 声明 一 个 2x2 的 二 维 整 型 数组 
var array [2][2]int 


// 设置 每 个 元 素 的 整 型 值 





array[6][6] 
array[6][1] 
array[1][6] 
array[1][1] 





只 要 类 型 一 致 ， 束 可 以 将 多 维 数组 互相 赋值 ， 如 代码 清单 4-12 所 
和 入 存储 在 元 系 中 的 数据 
型 














We 


代码 清单 4-12 ”同样 类 型 的 多 维 数 








日 赋值 




















// 声明 两 个 不 同 的 二 维 整 型 数组 
var array1 [2][2]int 
var array2 [2][2]int 























// 为 每 个 元 素 赋 值 
array2[6][6] = 16 
array2[6][1] = 26 
array2[1][8] = 

array2[1][1] = 46 





// 将 array2 的 值 复制 给 array1 
arrayl = array2 





因为 每 个 数组 都 是 一 个 值 ， 所 以 可 以 独立 复制 某 个 维度 ， 如 代码 清 
单 4-13 所 示 。 











代码 清单 4-13 ”使 用 索引 为 多 维 数 组 赋值 


























// 将 array1 的 索引 为 1 的 维度 复制 到 一 个 同类 型 的 新 数组 里 
var array3 [2]int = array1[1] 











// 将 外 层 数 组 的 索引 为 1、 内 层 数 组 的 索引 为 8 的 整 型 值 复制 到 新 的 整 型 变量 


var value int = array1[1][6] 




















4.1.5 在 函数 间 传 递 数组 


根据 内 存 和 性 能 来 看 ， 在 函数 间 传 递 数组 是 一 个 开销 很 大 的 操作 。 
在 函数 之 间 传 递 变量 时 ， 总 是 以 值 的 方式 传递 的 。 如 果 这 个 变量 是 一 个 
数组 ， 意 味 着 整个 数组 ， 不 管 有 多 长 ， 都 会 完整 复制 ， 并 传递 给 函数 。 


为 了 考察 这 个 操作 ， 我 们 来 创建 一 个 包含 100 万 个 int 类 型 元 素 的 
数组 。 在 64 位 架构 上 ， 这 将 需要 800 万 字 节 ， 即 8 MB 的 内 存 。 如 果 声 明 
并 将 其 传递 给 函数 ， 会 发 生 什么 呢 ? 如 代码 清单 4- 
14 有 未 。 























代码 清单 4-14 使 用 值 传递 ， 在 函数 间 传 递 大 数组 








// 声明 一 个 需要 8 MB 的 数组 


var array [1e6]int 


// 将 数组 传递 给 函数 foo 


foo(array) 


// 函数 foo 接 受 一 个 168 万 个 整 型 值 的 数组 
func foo(array [1e6]int) { 





} 





每 次 函数 foo 被 调用 时 ， 必 须 在 栈 上 分 配 8 MB 的 内 存 。 之 后 ， 整 
个 数组 的 值 (8 MB 的 内 存 ) 被 复制 到 刚 分 配 的 内 存 里 。 昌 然 Go 语言 自 
己 会 处 理 这 个 复制 操作 ， 不 过 还 有 一 种 更 好 且 更 有 效 的 方法 来 处 理 这 个 
操作 。 可 以 只 传 入 指向 数组 的 指针 ， 这 样 只 需要 复制 8 字 节 的 数据 而 不 
是 8 MB 的 内 存 数 据 到 栈 上 ， 如 代码 清单 4-15 所 示 。 


代码 清单 4-15 ”使 用 指针 在 函数 间 传 递 大 数组 





























// 分 配 一 个 需要 8 MB 的 数组 


var array [1e6]int 


// 将 数组 的 地 址 传递 给 函数 foo 
foo(&array) 





// 函数 foo 接 受 一 个 指向 168 万 个 整 型 值 的 数组 的 指针 
func foo(array *[1e6]int) { 














} 





这 次 函数 foo 接受 一 个 指向 100 万 个 整 型 值 的 数组 的 指针 。 现 在 将 
数组 的 地 址 传 入 函数 ， 只 需要 在 栈 上 分 配 8 字 节 的 内 存 给 指针 就 可 以 。 


这 个 操作 会 更 有 效 地 利用 内 存 ， 性 能 也 更 好 。 不 过 要 意识 到 ， 因 为 
现在 传递 的 是 指针 ， 所 以 如 果 改 变 指针 指向 的 值 ， 会 改变 共享 的 内 存 。 
如 你 所 见 ， 使 用 切片 能 更 好 地 处 理 这 类 共享 问题 。 

4.2 切片 的 内 部 实现 和 基础 功能 


切片 是 一 种 数据 结构 ， 这 种 数据 结构 便于 使 用 和 管理 数据 集合 。 








切片 是 围绕 动态 数组 的 概念 构建 的 ， 可 以 按 需 目 动 增长 和 缩小 。 切 瞩 的 
动态 增长 是 通过 内 置 函 数 append 来 实现 的 。 这 个 函数 可 以 快速 且 高 效 
地 增长 切片 。 还 可 以 通过 对 切片 再 次 切片 来 缩小 一 个 切片 的 大 小 。 因 为 
切片 的 底层 内 存 也 是 在 连续 块 中 分 配 的 ， 所 以 切片 还 能 获得 索引 、 友 代 
以 及 为 垃圾 回收 优化 的 好 处 。 





4.2.1 内 部 实现 


切片 是 一 个 很 小 的 对 象 ， 对 底层 数组 进行 了 抽象 ， 并 提供 相关 的 操 
作 方 法 。 切 片 有 3 个 字段 的 数据 结构 ， 这 些 数据 结构 包含 Go 语言 需要 操 
作 底 层 数组 的 元 数据 〈 见 图 4-9) 。 





整 型 切片 : 
3 5 长 度 为 3 个 整 型 什 
长 度 容量 容量 为 5 个 整 型 什 





图 4-9 ”切片 内 部 实现 ， 底层 数组 
这 3 个 字段 分 别 是 指 癌 底 层 数 组 的 指针 、 切 片 访问 的 元 素 的 个 数 
《 即 长 度 )》 和 切片 允许 增长 到 的 元 素 个 数 〈 即 容量 ) 。 后 面 会 进一步 讲 
解 长 度 和 容量 的 区 别 。 
4.2.2 ”创建 和 初始 化 


Go 语言 中 有 几 种 方法 可 以 创建 和 初始 化 切片 。 是 否 能 提前 知道 切 
片 需要 的 容量 通常 会 决定 要 如 何 创建 切片 。 


1，make 和 切片 字面 量 


一 种 创建 切片 的 方法 是 使 用 内 置 的 make 函数 。 当 使 用 make 时 ， 需 
要 传 入 一 个 参数 ， 指 定 切片 的 长 度 ， 如 代码 清单 4-16 所 示 。 


代码 清单 4-16 ”使 用 长 度 声明 一 个 字符 串 切 片 



































// 创建 一 个 字符 串 切 片 
// 其 长 度 和 容量 都 是 5 个 元 素 





slice := make([]string, 5) 





如 果 只 指定 长 度 ， 那 么 切片 的 容量 和 长 度 相 等 。 也 可 以 分 别 指定 长 
度 和 容量 ， 如 代码 清单 4-17 所 示 。 


























代码 清单 4-17 使 用 长 度 和 容量 声明 整 型 切片 


// 创建 一 个 整 型 切片 














// 其 长 度 为 3 个 元 素 ， 容 量 为 5 个 元 素 
slice := make([]int，3，5) 














分 别 指定 长 度 和 容量 时 ， 创 建 的 切片 ， 底 层 数 组 的 长 度 古 指定 的 容 
量 ， 但 是 初始 化 后 并 不 能 访问 所 有 的 数组 元 素 。 图 4-9 描 述 了 代码 清单 4- 
17 里 声明 的 整 型 切片 在 初始 化 并 存 入 一 些 值 后 的 样子 。 








代码 清单 4-17 中 的 切片 可 以 访问 3 个 元 素 ， 而 底层 数组 拥有 5 个 元 
素 。 剩 余 的 2 个 元 素 可 以 在 后 期 操作 中 合并 到 切片 ， 可 以 通过 切片 访问 
这 些 元 素 。 如 果 基 于 这 个 切片 创建 新 的 切片 ， 新 切片 会 和 原 有 切片 共 吾 
底层 数组 ， 也 能 通过 后 期 操作 来 访问 多 余 容 量 的 元 素 。 


不 允许 创建 容量 小 于 长 度 的 切片 ， 如 代码 清单 4-18 所 示 。 


代码 清单 4-18 容量 小 于 长 度 的 切片 会 在 编译 时 报错 


















































// 创建 一 个 整 型 切片 
// 使 其 长 度 大 于 容量 
slice := make([]int, 5, 3) 








Compiler Error: 
len larger than cap in make([]int) 





为 一 种 第 用 的 创建 切片 的 方法 是 使 用 切片 字面 量 ， 如 代码 清单 4-19 
所 示 。 这 种 方法 和 创建 数组 类 似 ， 只 是 不 需要 指定 [] 运算 符 里 的 值 。 
初始 的 长 度 和 容量 会 基于 初始 化 时 提供 的 元 素 的 个 数 确定 。 


代码 清单 4-19 ”通过 切片 字面 量 来 声明 切片 















































// 创建 字符 串 切 片 
// 其 长 度 和 容量 都 是 5 个 元 素 
slice := [J]string{"Red", "Blue", "Green", "Yellow", "Pink"} 








// 创建 一 个 整 型 切片 
// 其 长 度 和 容量 都 是 3 个 元 素 
slice := []int{f16，26，36} 








当 使 用 切片 字面 量 时 ， 可 以 设置 初始 长 度 和 容量 。 要 做 的 就 是 在 初 
始 化 时 给 出 所 需 的 长 度 和 容量 作为 索引 。 代 码 清单 4-20 中 的 语法 展示 了 


如 何 创建 长 度 和 容量 都 是 100 个 元 素 的 切片 。 





代码 清单 4-20 ”使 用 索引 声明 切 卢 








// 创建 字符 串 切片 
// 使 用 空 字符 串 初 始 化 第 168 个 元 素 





slice := [J]string{99: ""} 





记 住 ， 如 末 在 [] 运算 符 里 指定 了 一 个 值 ， 那 么 创建 的 就 是 数组 而 
不 是 切片 。 只 有 不 指定 值 的 时 候 ， 才 会 创建 切片 ， 如 代码 清单 4-21 所 


钞 。 








代码 清单 4-21 声明 数组 和 声明 切片 的 不 同 








// 创建 有 3 个 元 素 的 整 型 数组 
array := [3]int{16，26，361} 




















// 创建 长 度 和 容量 都 是 3 的 整 型 切片 
slice := []int{f16，26，36} 








2. ni 和 空 切 片 


有 时 ， 程 序 可 能 需要 声明 一 个 值 为 nil 的 切片 (也 称 nil 切片 ) 。 
只 要 在 声明 时 不 做 任何 初始 化 ， 就 会 创建 一 个 nil 切片 ， 如 代码 清单 4- 
22 所 示 。 























代码 清单 4-22 ”创建 nil 切 片 

















// 创建 nil 整 型 切片 


var slice [J]int 





在 Go 语言 里 ，nil 切片 是 很 第 见 的 创建 切片 的 方法 。nil 切片 可 以 
用 于 很 多 标准 库 和 内 置 函 数 。 在 需要 描述 一 个 不 存在 的 切片 时 ，nil 切 
厂 会 很 好 用 。 例 如 ， 函 数 要 求 返 回 一 个 切片 但 是 发 生 寞 常 的 时 候 〈 见 图 
4-10) 。 








var slice []int 





图 4-10 ”nil 切片 的 表示 


利用 初始 化 ， 通 过 声明 一 个 切片 可 以 创建 一 个 空 切 片 ， 如 代码 清单 
4-23 所 示 。 























代码 清单 4-23 ”声明 空 切 片 


// 使 用 make 创 建 空 的 整 型 切片 
slice := make([]int, ©8) 





// 使 用 切片 字面 量 创建 空 的 整 型 切片 
slice := []int{} 











空 切片 在 底层 数组 包含 0 个 元 素 ， 也 没有 分 配 任 何 存 储 空间 。 想 表 
0 例如 ， 数 据 库 碍 询 返 回 0 个 碍 询 结果 时 〈 见 
4-11) 。 


地 址 0 
指针 长 度 


slice := makelt[]int，0) 


SLLIGe, 3 [IntE) 





图 4-11 ” 空 切 片 的 表示 


不 管 是 使 用 nil 切片 还 是 空 切 片 ， 对 其 调用 内 置 函数 append 、len 
和 cap 的 效果 都 是 一 样 的 。 


4.2.3 ”使 用 切 厂 


现在 知道 了 什么 是 切片 ， 也 知道 如 何 创建 切片 ， 来 看 看 如 何在 程序 
里 使 用 切片 。 


1. 赋值 和 切片 


对 切片 里 某 个 索引 指向 的 元 素 赋 值 和 对 数组 里 某 个 索引 指向 的 元 素 
赋值 的 方法 完全 一 样 。 使 用 [] 操作 符 就 可 以 改变 某 个 元 素 的 值 ， 如 代 
码 清 单 4-24 所 示 。 











代码 清单 4-24 ”使 用 切片 字面 量 来 声明 切片 























// 创建 一 个 整 型 切片 
// 其 容量 和 长 度 都 是 5 个 元 素 
slice := []int{f16，26，36，46，561} 





// 改变 索引 为 1 的 元 素 的 值 
slice[1] = 25 








切片 之 所 以 被 称 为 切片 ， 是 因为 创建 一 个 新 的 切片 就 是 把 底层 数组 
切 出 一 部 分 ， 如 代码 清单 4-25 所 示 。 

















代码 清单 4-25 ”使 用 切片 创建 切片 











// 创建 一 个 整 型 切片 
// 其 长 度 和 容量 都 是 5 个 元 素 
slice := []int{f16，26，36，46，561} 











// 创建 一 个 新 切片 
// 其 长 度 为 2 个 元 素 ， 容 量 为 4 个 元 素 
newSlice := slice[1:3] 











执行 完 代 码 清 单 4-25 中 的 切片 动作 后 ， 我 们 有 了 两 个 切片 ， 它 们 
Cr 0 
( 见 图 4-12) 。 


sliees w= (Jinttlyd, 


[0] [1] [21 [3] [41 
[0] [1] [21] [3] 


地 址 2 4 
指针 长 度 容量 


newSlice := SlLlice[1:3] 

















图 4-12 ”共享 同一 底层 数组 的 两 个 切片 


第 一 个 切片 slice 能 够 看 到 底层 数组 全 部 5 个 元 素 的 容量 ， 不 过 之 
后 的 newSlice 就 看 不 到 。 对 于 newSlice ， 底 层 数组 的 容量 只 有 4 个 元 
素 。newS1lice 无 法 访问 到 它 所 指 癌 的 底层 数组 的 第 一 个 元 素 之 前 的 部 


A 


分 。 所 以 ， 对 newSlice 来 说 ， 之 前 的 那些 元 素 就 是 不 存在 的 。 











使 用 代码 清单 4-26 所 示 的 公式 ， 可 以 计算 出 任意 切片 的 长 度 和 容 


可 


代码 清单 426 如何 计算 长 度 和 容量 


























对 底层 数组 容量 是 k 的 切片 slice[i:j] 来 说 
长 度 : j - 





容量 : 








对 newSlice 应 用 这 个 公式 就 能 得 到 代码 清单 4-27 所 示 的 数字 。 





代码 清单 4-27 计算 新 的 长 度 和 容量 

















对 底层 数组 容量 是 5 的 切片 slice[1:3] 来 说 











长 度 : 2 
容量 : - 4 











可 以 用 另 一 种 方法 来 描述 这 几 个 值 。 第 一 个 值 表示 新 切片 开始 的 元 
素 的 索引 位 置 ， 这 个 例子 中 是 1。 第 二 个 值 表 示 开 始 的 索引 位 置 〈1) ， 
加 上 和 希望 包含 的 元 素 的 个 数 〈2) ，1+2 的 结果 是 3， 所 以 第 二 个 值 就 是 
3。 容 量 是 该 与 切片 相关 联 的 所 有 元 素 的 数量 。 


需要 记 住 的 是 ， 现 在 两 个 切片 共享 同一 个 底层 数组 。 如 果 一 个 切片 
修改 了 该 底层 数组 的 共享 部 分 ， 另 一 个 切片 也 能 感知 到 ， 如 代码 清单 4- 
28 所 示 。 



































代码 清单 4-28 ”修改 切片 内 容 可 能 导致 的 结果 





// 创建 一 个 整 型 切片 
// 其 长 度 和 容量 都 是 5 个 元 素 
slice := []int{f16，26，36，46，561} 














// 创建 一 个 新 切片 
// 其 长 度 是 2 个 元 素 ， 容 量 是 4 个 元 素 
newSlice := slice[1:3] 











// 修改 newSlice 索 引 为 1 的 元 素 
// 同时 也 修改 了 原来 的 slice 的 索引 为 2 的 元 素 
newSlice[1] = 35 








把 35 赋 值 给 newSslice 的 第 二 个 元 素 ( 索 引 为 1 的 元 素 )〉 的 同时 也 是 
在 修改 原来 的 slice 的 第 3 个 元 素 〈 索 引 为 2 的 元 素 ) 〈 见 图 4-13) 。 





全 全 三 【0s 





[0] [1] [2] [3 ] [4] 
[0 ] [1] [2] [3] 


4 对 newSlice 执 行 赋值 操作 之 后 
长 度 容量 newSslice[1] = 35 


newSlice := slice[l:3] 








图 4-13 ”赋值 操作 之 后 的 底层 数组 


切片 只 能 访问 到 其 长 度 内 的 元 素 。 试 图 访问 超出 其 长 度 的 元 系 将 会 
导致 语言 运行 时 异常 ， 如 代码 清单 4-29 所 示 。 与 切片 的 容量 相关 联 的 元 
Ue 在 使 用 这 部 分 元 系 前 ， 必 须 将 其 合并 到 切片 的 长 
度 里 。 














代码 清单 429 表示 索引 越界 的 语言 运行 时 错误 














// 创建 一 个 整 型 切片 
// 其 长 度 和 容量 都 是 5 个 元 素 
slice := []int{106, 206, 306, 406，506} 











// 创建 一 个 新 切片 
// 其 长 度 为 2 个 元 素 ， 容 量 为 4 个 元 素 
newSlice := slice[1:3] 








// 修改 newSlice 索 引 为 3 的 元 素 
// 这 个 元 素 对 于 newSlice 来 说 并 不 存在 
newSlice[3] = 45 








Runtime Exception: 


panic: runtime error: index out of range 





切片 有 额外 的 容量 是 很 好 ， 但 是 如 末 不 能 把 这 些 容量 合并 到 切片 的 
长 度 里 ， 这 些 容量 束 没 有 用 处 。 好 在 可 以 用 Go 语言 的 内 置 函 数 append 
来 做 这 种 合并 很 容易 。 


2. 切片 增长 


相对 于 数组 而 言 ， 使 用 切片 的 一 个 好 处 是 ， 可 以 按 需 增加 切片 的 容 
量 。Go 语 言 内 置 的 append 函数 会 处 理 增加 长 度 时 的 所 有 操作 细 市 。 


要 使 用 append ， 需 要 一 个 被 操作 的 切片 和 一 个 要 追加 的 值 ， 如 代 
码 清单 4-30 所 示 。 当 append 调用 返回 时 ， 会 返回 一 个 包含 修改 结果 的 
新 切片 。 函 数 append 总 是 会 增加 新 切片 的 长 度 ， 而 容量 有 可 能 会 改 
变 ， 也 可 能 不 会 改变 ， 这 取决 于 被 操作 的 切片 的 可 用 容量 。 


代码 清单 430 使 用 append 向 切片 增加 元 素 





























// 创建 一 个 整 型 切片 
// 其 长 度 和 容量 都 是 5 个 元 素 
slice := []int{f16，26，36，46，561} 











// 创建 一 个 新 切片 
// 其 长 度 为 2 个 元 素 ， 容 量 为 4 个 元 素 
newSlice := slice[1:3] 























// 使 用 原 有 的 容量 来 分 配 一 个 新 元 素 
// 将 新 元 素 赋 值 为 66 


newSlice = append(newSlice, 60) 

















当代 码 清单 4-30 中 的 append 操作 完成 后 ， 两 个 切片 和 后 层 数 组 的 
布局 如 图 4-14 所 示 。 

















newSlice = append (newSlice, 











图 4-14 append 操作 之 后 的 底层 数组 


因为 newSlice 在 底层 数组 里 还 有 额外 的 容量 可 用 ，append 操作 将 
可 用 的 元 素 合并 到 切片 的 长 度 ， 并 对 其 进行 赋值 。 由 于 和 原始 的 slice 
共享 同一 个 底层 数组 ，slice 中 索引 为 3 的 元 素 的 值 也 被 改动 了 。 


De 
个 新 的 底层 数组 ， 将 被 引用 的 现 有 的 值 复 制 到 新 数组 里 ， 再 追加 新 的 
值 ， 如 代码 清单 4-31 所 示 。 









































代码 清单 4-31 使 用 append 同时 增加 切片 的 长 度 和 容量 





// 创建 一 个 整 型 切片 
// 其 长 度 和 容量 都 是 4 个 元 素 
slice := []int{f16，26，36，46} 





// 向 切片 退 加 一 个 新 元 素 
// 将 新 元 素 赋值 为 56 


newSlice := append(slice, 50) 








当 这 个 append 操作 完成 后 ，newSlice 拥有 一 个 全 新 的 底层 数组 ， 
这 个 数组 的 容量 是 原来 的 两 倍 〈 见 图 4-15) 。 





Slice. se [lint{L0, 


newSlice := append(slice, 50) 


图 4-15 append 操作 之 后 的 新 的 底层 数组 


函数 append 会 智能 地 处 理 底层 数组 的 容量 增长 。 在 切片 的 容量 小 
于 1000 个 元 素 时 ， 总 是 会 成 倍 地 增加 上 容量。 一旦 元 素 个 数 超过 1000， 容 
量 的 增长 因子 会 设 为 1.25， 也 就 是 会 每 次 增加 25% 的 容量 。 随 着 语言 的 
演化 ， 这 种 增长 算法 可 能 会 有 所 改变 。 


3. 创建 切片 时 的 3 个 索引 


在 创建 切片 时 ， 还 可 以 使 用 之 前 我 们 没有 提 及 的 第 三 个 索引 选项 。 
第 三 个 索引 可 以 用 来 控制 新 切片 的 容量 。 其 目的 并 不 是 要 增加 容量 ， 而 
古 要 限制 容量 。 可 以 看 到 ， 人 允许 限制 新 切 厂 的 容量 为 底层 数组 提供 了 一 
定 的 保护 ， 可 以 更 好 地 控制 追加 操作 。 























让 我 们 看 看 一 个 包含 5 个 元 素 的 字符 串 切片 。 这 个 切片 包含 了 本 地 
超市 能 找到 的 水 果 名 字 ， 如 代码 清单 4-32 所 示 。 


代码 清单 432 使 用 切片 字面 量 声明 一 个 字符 串 切 片 














// 创建 字符 串 切 片 
// 其 长 度 和 容量 都 是 5 个 元 素 





source := []string{"Apple", "Orange", "Plum", "Banana", "Grape"} 





如 果 查 看 这 个 包含 水 果 的 切片 的 值 ， 束 像 图 4-16 所 展示 的 样子 。 


source := []string{"Apple", “Orange", "Plum", "Banana", "Grape"} 


地 址 5 
指针 长 度 


[0] [1] [2] [3] [4] 
图 4-16 ”字符 串 切 片 的 表示 


现在 ， 让 我 们 试 着 用 第 三 个 索引 选项 来 完成 切片 操作 ， 如 代码 清单 
4-33 上 所 示 。 






































代码 清单 4-33 ”使 用 3 个 索引 创建 切片 

















// 将 第 三 个 元 素 切 片 ， 并 限制 容量 
// 其 长 度 为 1 个 元 素 ， 容 量 为 2 个 元 素 














slice := source[2:3:4] 








这 个 切片 操作 执行 后 ， 新 切片 里 从 底层 数组 引用 了 1 个 元 素 ， 容 量 
是 2 个 元 素 。 具 体 来 说 ， 新 切片 引用 了 Plum 元 素 ， 并 将 容量 扩展 
到 Banana 元 素 ， 如 图 4-17 所 示 。 











source := []string{"Apple", "Orange", "Plum", "Banana", "Grape"} 


地 址 8 
指针 长 度 容量 


[0] [1] [2] [3] [4] 
[0] [1 [2] 


] 





地 址 1 2 
指针 长 度 容量 
slice := Source[2:3:4] 











图 4-17 ”操作 之 后 的 新 切片 的 表示 


我 们 可 以 应 用 之 前 定义 的 公式 来 计算 新 切片 的 长 度 和 容量 ， 如 代码 
清单 4-34 所 示 。 











代码 清单 4-34 ”如 何 计算 长 度 和 容量 








对 于 slice[i:j:k] 或 [2:3: 


-或 3 
-或 4 











和 之 前 一 样 ， 第 一 个 值 表 示 新 切片 开始 的 元 素 的 索引 位 置 ， 这 个 例 

子 中 是 2。 第 二 个 值 表 示 开 始 的 索引 位 置 〈2) 加 上 和 希望 包括 的 元 素 的 个 

数 (1) ，2+1 的 结果 是 3， 所 以 第 二 个 值 就 是 3。 为 了 设置 容量 ， 从 索引 

0 
4。 


如 采 试 图 设置 的 容量 比 可 用 的 容量 还 大 ， 就 会 得 到 一 个 语言 运行 时 
昔 误 ， 如 代码 清单 4-35 所 示 。 




















代码 清单 435 ”设置 容量 大 于 已 有 容量 的 语言 运行 时 错误 

















// 这 个 切片 操作 试图 设置 容量 大 
// 这 比 可 用 的 容量 大 


slice := source[2:3:6] 





























Runtime Error: 
panic: runtime error: slice bounds out of range 





我 们 之 前 讨论 过 ， 内 置 函 数 append 会 首先 使 用 可 用 容量 。 一 旦 没 
有 可 用 容量 ， 会 分 配 一 个 新 的 底层 数组 。 这 导致 很 容易 怎 记 切 片 间 正 在 
共 至 同一 个 底层 数组 。 一 旦 发 生 这 种 情况 ， 对 切片 进行 修改 ， 很 可 能 会 
导致 随机 且 奇 怪 的 问题 。 对 切片 内 容 的 修改 会 影响 多 个 切片 ， 却 很 难 找 
到 问题 的 原因 。 


如 果 在 创建 切片 时 设置 切片 的 容量 和 长 度 一 样 ， 就 可 以 强制 让 新 切 
片 的 第 一 个 append 操作 创建 新 的 底层 数组 ， 与 原 有 的 底层 数组 分 离 。 
人 可 以 安全 地 进行 后 续 修 改 ， 如 代码 清 

4-36 所 不 。 











代码 清单 4-36 ”设置 长 度 和 容量 一 样 的 好 处 














// 创建 字符 串 切 片 
// 其 长 度 和 容量 都 是 5 个 元 素 
source := []string{"Apple", "Orange", "Plum", "Banana", "Grape"} 





// 对 第 三 个 元 素 做 切片 ， 并 限制 容量 
// 其 长 度 和 容量 都 是 1 个 元 素 
slice := source[2:3:3] 














// 向 slice 追 加 新 字符 串 
slice = append(slice, "Kiwi") 











如 果 不 加 第 三 个 索引 ， 由 于 剩余 的 所 有 容量 都 属于 slice ， 
癌 slice 追加 Kiwi 会 改变 原 有 底层 数组 索引 为 3 的 元 素 的 值 Banana 。 
不 过 在 代码 清单 4-36 中 我 们 限制 了 slice 的 容量 为 1。 当 我 们 第 一 次 对 
slice 调用 append 的 时 候 ， 会 创建 一 个 新 的 底层 数组 ， 这 个 数组 包括 2 
个 元 素 ， 并 将 水 果 Plum 复制 进来 ， 再 退 加 新 水 果 Kiwi ， 并 返回 一 个 引 
用 了 这 个 底层 数组 的 新 切片 ， 如 图 4-18 所 示 。 





slice := source[2:3:3] 


地 址 1 
指针 长 度 


[0] [1] [2] 


slice = append(slice, "Kiwi" 


地 址 Plum Kiwi 
指针 a 


图 4-18 ”append 操作 之 后 的 新 切片 的 表示 


因为 新 的 切片 slice 拥有 了 自己 的 底层 数组 ， 所 以 杜绝 了 可 能 肥 生 
的 问题 。 我 们 可 以 继续 向 新 切片 里 奶 加 水 果 ， 而 不 用 担心 会 不 小 心 修改 
了 其 他 切 厂 里 的 水 果 。 同 时 ， 也 保持 了 为 切片 申请 新 的 克 层 数组 的 简 


v3 
1 日 o 











内 置 函 数 append 也 是 一 个 可 变 参数 的 函数 。 这 意味 着 可 以 在 一 次 
调用 传递 多 个 追加 的 值 。 如 宁 使 用 . . . 运算 符 ， 可 以 将 一 个 切片 的 所 有 
元 素 追 加 到 另 一 个 切片 里 ， 如 代码 清单 4.37 所 示 。 


代码 清 




















4-37 将 一 个 切片 追加 到 另 一 个 切片 





























// 创建 两 个 切片 ， 并 分 别 用 两 个 整数 进行 初始 化 
s1 := [J]int{1, 2} 
s2 := [J]int{3, 4} 














// 将 两 个 切片 奶 加 在 一 起 ， 并 显示 结果 


fmt.Printf("%v\n", append(s1, s2...)) 


Output: 
[1 2 3 4] 





就 像 通过 输出 看 到 的 那样 ， 切 片 s2 里 的 所 有 值 都 退 加 到 了 切片 s1 
的 后 面 。 使 用 Printf 时 用 来 显示 append 函数 返回 的 新 切片 的 值 。 


4. 迭代 切片 
既然 切片 是 一 个 集合 ， 可 以 欠 代 其 中 的 元 素 。Go 语 言 有 个 特殊 的 


关键 字 range ， 它 可 以 配合 关键 字 for 来 迭代 切片 里 的 元 素 ， 如 代码 清 
单 4-38 所 示 。 





代码 清单 4-38 使 用 for range 迭代 切片 











// 创建 一 个 整 型 切片 
// 其 长 度 和 容量 都 是 4 个 元 素 
slice := []int{f16，26，36，46} 





// 和 从 代 每 一 个 元 素 ， 并 显示 其 值 
for index, value := range slice { 
fmt.Printf("Index: %d Value: %d\n", index, value) 





} 


Output: 
Index: 
Index: 
Index: 
Index: 





当 迭 代 切 片 时 ， 关 键 字 range 会 返回 两 个 值 。 第 一 个 值 是 当前 迭代 
到 的 索引 位 置 ， 第 二 个 值 是 该 位 置 对 应 元 素 值 的 一 份 副本 《〈 见 图 4- 
19»5 





10 20 30 40 


副本 副本 副本 副本 


0 10 1 20 2 30 3 40 
索引 || 值 索引 | 值 索引 | 值 索引 || 值 


for index, value := range slice f{ 


























图 4-19 ”使 用 range 迭代 切片 会 创建 每 个 元 素 的 副本 


需要 强调 的 是 ，range 创建 了 每 个 元 素 的 副本 ， 而 不 是 直接 返回 对 
该 元 素 的 引用 ， 如 代码 清单 4-39 所 示 。 如 有 果 使 用 该 值 变 量 的 地 址 作为 指 
加 每 个 元 系 的 指针 ， 就 会 造成 错误 。 让 我 们 看 看 是 为 什么 。 


代码 清 间 



































4-39 range 提供 了 每 个 元 素 的 副本 














// 创建 一 个 整 型 切片 
// 其 长 度 和 容量 都 是 4 个 元 素 
slice := []int{f16，26，36，46} 








// 和 从 代 每 个 元 素 ， 并 显示 值 和 地 址 
for index, value := range slice { 
fmt.Printf("Value: %d Value-Addr: %X ElemAddr: %X\n", 
value, &value, &slice[index]) 


Output : 

Value: 16 Value-Addr: 16566168 ElemAddr: 1652E166 
Value: 26 Value-Addr: 16566168 ElemAddr: 1652E164 
Value: 36 Value-Addr: 16566168 ElemAddr: 1652E168 
Value: 46 Value-Addr: 16566168 ElemAddr: 1652E16C 





因为 欠 代 返回 的 变量 是 一 个 途 代 过 程 中 根据 切片 依次 赋值 的 新 变 
量 ， 所 以 value 的 地 址 总 是 相同 的 。 要 想 获取 每 个 元 素 的 地 址 ， 可 以 使 
用 切片 变量 和 索引 值 。 


如 采 不 需要 索引 值 ， 可 以 使 用 占 位 字符 来 忽略 这 个 值 ， 如 代码 清单 
4-40 所 示 。 











代码 清单 4-40 ”使 用 空白 标识 符 〈 下 划 线 ) 来 忽略 索引 值 








// 创建 一 个 整 型 切片 
// 其 长 度 和 容量 都 是 4 个 元 素 
slice := []int{f16，26，36，46} 








// 迭代 每 个 元 素 ， 并 显示 其 值 
for _, value := range slice { 
fmt.Printf("Value: %d\n", value) 


} 


Output: 
Value: 
Value: 
Value: 
Value: 





关键 字 range 总 是 会 从 切片 尖 部 开始 迭代 。 如 末 想 对 达 代 做 更 多 的 
控制 ， 依 旧 可 以 使 用 传统 的 for 循环 ， 如 代码 清单 4-41 所 示 。 


代码 清单 4-41 使 用 传统 的 for 循环 对 切片 进行 迭代 















































// 创建 一 个 整 型 切片 
// 其 长 度 和 容量 都 是 4 个 元 素 
slice := []int{f16，26，36，46} 





// 从 第 三 个 元 素 开始 达 代 每 个 元 素 


for index := 2; index < len(slice); index++ { 





fmt.Printf("Index: %d Value: %d\n", index, slice[index]) 
} 


Output: 
Index: 2 Value: 36 
Index: 3 Value: 46 





有 两 个 特殊 的 内 置 函数 len 和 cap ， 可 以 用 于 处 理 数 组 、 切 片 和 通 
道 。 对 于 切片 ， 函 数 len 返回 切片 的 长 度 ， 函 数 cap 返回 切片 的 容量 。 





人 单 4-41 里 ， 我 们 使 用 函数 len 来 决 宪 什么 时 候 停 止 对 切片 的 迭 
现在 知道 了 如 何 创建 和 使 用 切片 。 可 以 组 合 多 个 切片 成 为 多 维 切 

片 ， 并 对 其 进行 迭代 。 

4.2.4 多维 切 片 


和 数组 一 样 ， 切 片 是 一 维 的 。 不 过 ， 和 之 前 对 数组 的 讨论 一 样 ， 可 
以 组 合 多 个 切片 形成 多 维 切 片 ， 如 代码 清单 4-42 所 示 。 


代码 清单 4-42 ”声明 多 维 切片 


























// 创建 一 个 整 型 切片 的 切片 
slice := [][]int{{16}, {1606, 26060}} 





我 们 有 了 一 个 包含 两 个 元 素 的 外 层 切 片 ， 每 个 元 素 包 含 一 个 内 层 的 
整 型 切片 。 切 片 slice 的 值 看 起 来 像 图 4-20 展 示 的 样子 。 





SLioe Se Ll [lint( tL 0 F100 093 二 


地 址 多 2 
指针 长 度 容量 














图 4-20” 整 型 切片 的 切片 的 值 


在 图 4-20 里 ， 可 以 看 到 组 合 切 片 的 操作 是 如 何 将 一 个 切片 谍 入 到 羽 
一 个 切片 中 的 。 外 层 的 切片 包括 两 个 元 素 ， 每 个 元 素 部 是 一 个 切片 。 第 
一 个 元 素 中 的 切片 使 用 单个 整数 10 来 初始 化 ， 第 二 个 元 素 中 的 切片 包括 
两 个 整数 ， 即 100 和 200。 


这 种 组 合 可 以 让 用 户 创建 非常 复杂 且 强 大 的 数据 结构 。 己 经 学 过 的 
ey 
单 4-43 所 示 。 














代码 清单 4-43 组合 切片 的 切片 





// 创建 一 个 整 型 切片 的 切片 
slice := [][]int{{16}, {1606, 2606}} 





// 为 第 一 个 切片 人 奶 加 值 为 26 的 元 素 
slice[6] = append(slLice[6]，26) 








Go 语言 里 使 用 append 函数 处 理 退 加 的 方式 很 简明 : 先 增长 切片 ， 
再 将 新 的 整 型 切片 赋值 给 外 层 切 片 的 第 一 个 元 素 。 当 代码 清单 4-43 中 的 
操作 完成 后 ， 会 为 新 的 整 型 切片 分 配 新 的 底层 数组 ， 然 后 将 切记 复制 到 
外 层 切 片 的 索引 为 0 的 元 素 ， 如 图 4-21 所 示 。 








Slice se [lL]int{{t10}), 00，20011 


2 2 append 之 后 
长 度 容量 


| slice[0] 


append 之 前 






= append (slice[0], 20) 




















图 4-21 append 操作 之 后 外 层 切 片 索引 为 0 的 元 素 的 布局 


即便 是 这 么 简单 的 多 维 切 片 ， 操 作 时 也 会 涉及 众多 布局 和 值 。 看 起 
来 在 函数 间 像 这 样 传递 数据 结构 也 会 很 复杂 。 不 过 切片 本 身 结 构 很 简 
单 ， 可 以 以 很 小 的 成 本 在 函数 间 传 递 。 


4.2.5 在 函数 间 传 递 切 片 


在 函数 间 传 递 切 片 驶 是 要 在 函数 间 以 值 的 方式 传递 切片 。 由 于 切片 
的 尺寸 很 小 ， 在 函数 间 复 制 和 传递 切片 成 本 也 很 低 。 让 我 们 创建 一 个 大 
切片 ， 并 将 这 个 切片 以 值 的 方式 传递 给 函数 foo ， 如 代码 清单 4-44 所 
外。 














代码 清单 4-44 在 函数 间 传 递 切片 











// 分 配 包含 166 万 个 整 型 值 的 切片 
slice := make([]int，1e6) 





// 将 slice 传 递 到 函数 foo 


slice = foo(slice) 


// 函数 foo 接 收 一 个 整 型 切片 ， 并 返回 这 个 切片 
func foo(slice []int) []int { 





return slice 


”| 

在 64 位 架构 的 机 器 上 ， 一 个 切片 需要 24 字 节 的 内 存 : 指针 字段 需要 
8 字 节 ， 长 度 和 容量 字段 分 别 需 要 8 字 节 。 由 于 与 切片 关联 的 数据 包含 
在 底层 数组 里 ， 不 属于 切片 本 身 ， 所 以 将 切片 复制 到 任意 函数 的 时 候 ， 
对 底层 数组 大 小 都 不 会 有 影响 。 复 制 时 只 会 复制 切片 本 身 ， 不 会 涉及 底 
层 数 组 〈 见 图 4-22) 。 








项 数 main 
slice := make([]int ，1000000) 


地 址 1000000 | 1000000 
指针 长 度 容量 


函数 调用 时 复制 切片 





[0] [1] [2] [3] 且 册 | 





函数 foo 





func foo(slice []int) []zint 


1000000 1000000 | 函数 返回 时 复制 切片 
长 度 容量 


图 4-22 ”函数 调用 之 后 两 个 切片 指向 同一 个 底层 数组 

在 函数 间 传 递 24 字 节 的 数据 会 非常 快速 、 简 单 。 这 也 是 切片 效率 高 
的 地 方 。 不 需要 传递 指针 和 处 理 复杂 的 语法 ， 只 需要 复制 切片 ， 按 想 要 
的 方式 修改 数据 ， 然 后 传递 回 一 份 新 的 切片 副本 。 
4.3 有 映射 的 内 部 实现 和 基础 功能 

映射 是 一 种 数据 结构 ， 用 于 存储 一 系列 无 序 的 键 值 对 

映射 里 基于 键 来 存储 值 。 图 4-23 通 过 一 个 例子 展示 了 映射 里 键 值 对 


征 如 何 存 储 的 。 映 射 功能 强大 的 地 方 是 ， 能 够 基于 键 快 速 检索 数据 。 键 
就 像 索引 一 样 ， 指 辐 与 该 键 关联 的 值 。 

















Red #da1337 Orange #e95a22 Green #a3ff47 
键 值 键 值 键 值 


图 4-23 ” 键 值 对 的 关系 





4.3.1 内 部 实现 


映射 是 一 个 集合 ， 可 以 使 用 类 似 处 理 数 组 和 切片 的 方式 迭代 映射 中 
的 元 素 。 但 映射 是 无 序 的 集合 ， 意 味 着 没有 办 法 预测 键 值 对 个 返回 的 顺 
序 。 即 便 使 用 同样 的 顺序 保存 键 值 对 ， 每 次 迭代 映射 的 时 候 顺 序 也 可 能 
不 一 样 。 无 序 的 原因 是 映射 的 实现 使 用 了 散 列 表 ， 见 图 4-24。 





映射 散 列 表 


散 列 值 低位 散 列 值 低位 散 列 值 低位 散 列 值 低位 


[0] [11 [2] [3] [4] [5] [6] [7] 


散 列 | 散 列 | 散 列 | 散 列 | 散 列 as 2 es 


数组 使 用 散 列 值 高 位 来 区 分 不 同 项 


|e |e 


键 和 值 被 打包 在 一 起 








图 4-24 ”映射 的 内 部 结构 的 简单 表示 


映射 的 散 列 表 包 含 一 组 桶 。 在 存储 、 删 除 或 者 查找 键 值 对 的 时 候 ， 
所 有 操作 都 要 驳 选 择 一 个 棋 。 把 操作 映射 时 指定 的 键 传 给 映射 的 散 列 函 
数 ， 束 能 选中 对 应 的 棚 。 这 个 散 列 函数 的 目的 是 生成 一 个 索引 ， 这 个 索 
引 最 终 将 键 值 对 分 布 到 所 有 可 用 的 桶 里 。 


随 着 映射 存储 的 增加 ， 索 引 分 布 越 均匀 ， 访 问 键 值 对 的 速度 就 越 
快 。 如 果 你 在 映射 里 存储 了 10 000 个 元 素 ， 你 不 希望 每 次 查找 都 要 访问 
10 000 个 键 值 对 才能 找到 需要 的 元 素 ， 你 希望 查找 键 值 对 的 次 数 越 少 越 
好 。 对 于 有 10 000 个 元 系 的 映射 ， 每 次 查找 只 需要 碍 找 8 个 键 值 对 才 是 
0 











Go 语言 的 映射 生成 散 列 键 的 过 程 比 图 4-25 展 示 的 过 程 要 稍微 长 一 
些 ， 不 过 大 体 过 程 是 类 似 的 。 在 我 们 的 例子 里 ， 键 是 字符 串 ， 代 表 凑 
色 。 这 些 字 符 串 会 转换 为 一 个 数值 〈《 散 列 值 ) 。 这 个 数值 落 在 映射 己 有 
棚 的 序号 范围 内 表示 一 个 可 以 用 于 存储 的 棚 的 序号 。 之 后 ， 这 个 数值 束 








被 用 于 选择 柄 ， 用 于 存储 或 者 查找 指定 的 键 值 对 。 对 Go 语言 的 映射 来 
0 





















Brick red 


键 散 列 值 / 桶 


| 00 | 01 | 02 | 03 | 
一 2 
08 | 09 | 10 | 
站 























Banana yellow 
Sweet pink 











图 4-25 ”简单 描述 散 列 函数 是 如 何 工 作 的 


如 傈 再 仔细 看 看 图 4-24， 丈 能 看 出 桶 的 内 部 实现 。 映 射 使 用 两 个 数 
据 结 构 来 存储 数据 。 第 一 个 数据 结构 是 一 个 数组 ， 内 部 存储 的 是 用 于 选 
择 桶 的 散 列 键 的 高 八 位 值 。 这 个 数组 用 于 区 分 每 个 键 值 对 要 存在 哪个 桶 
里 。 第 二 个 数据 结构 是 一 个 字 节 数组 ， 用 于 存储 键 值 对 。 该 字 节 数组 先 
依次 存储 了 这 个 棚 里 所 有 的 键 ， 之 后 依次 存储 了 这 个 桶 里 所 有 的 值 。 实 
现 这 种 键 值 对 的 存储 方式 目的 在 于 减少 每 个 桶 所 需 的 内 存 。 


映射 撒 层 的 实现 还 有 很 多 细节 ， 不 过 这 些 细 布 超出 了 本 书 的 范畴 。 


创建 并 使 用 映射 并 不 需要 了 解 所 有 的 细节 ， 只 要 记 住 一 件 事 : 映射 是 一 
个 存储 键 值 对 的 无 序 集合 。 


4.3.2 ”创建 和 初始 化 


Go 语言 中 有 很 多 种 方法 可 以 创建 并 初始 化 映射 ， 可 以 使 用 内 置 的 
make 冰 数 《如 代码 清单 4-45 所 示 ) ， 也 可 以 使 用 映射 字面 量 。 











代码 清单 4-45 ”使 用 make 声明 映射 











// 创建 一 个 映射 ， 键 的 类 型 是 string， 值 的 类 型 是 int 
dict := make(map[string]int) 








// 创建 一 个 映射 ， 键 和 值 的 类 型 都 是 string 
// 使 用 两 个 键 值 对 初始 化 映射 
dict := map[string]string{"Red": "#da1l337", "Orange": "#e95a22"} 














创建 映射 时 ， 更 常用 的 方法 是 使 用 映射 字面 量 。 映 射 的 初始 长 度 会 
根据 初始 化 时 指定 的 键 值 对 的 数量 来 确定 。 


映射 的 键 可 以 是 任何 值 。 这 个 值 的 类 型 可 以 是 内 置 的 类 型 ， 也 可 以 
是 结构 类 型 ， 只 要 这 个 值 可 以 使 用 == 运算 符 做 比较 。 切 片 、 函 数 以 及 
包含 切片 的 结构 类 型 这 之 些 类 型 由 于 具有 引用 语义 ， 不 能 作为 映射 的 键 ， 
使 用 这 些 类 型 会 造成 编译 错误 ， 如 代码 清单 4-46 所 示 。 


代码 清单 4-46 ”使 用 映射 字面 量 声明 空 映射 



































// 创建 一 个 映射 ， 使 用 字符 串 切 片 作为 映射 的 键 
dict := map[[]string]int{} 





Compiler Exception: 
invalid map key type []jstring 





没有 任何 理由 阻止 用 户 使 用 切片 作为 映射 的 值 ， 如 代码 清单 4-47 所 
示 。 这 个 在 使 用 一 个 映射 键 对 应 一 组 数据 时 ， 会 非常 有 用 。 


4-47 声明 一 个 存储 字符 串 切 片 的 映射 











代码 清 间 

















// 创建 一 个 映射 ， 使 用 字符 串 切 片 作为 值 








dict := map[int][]string{} 





4.3.3 ”使 用 映射 


键 值 对 赋值 给 映射 ， 是 通过 指定 适当 类 型 的 键 并 给 这 个 键 赋 一 个 值 
来 完成 的 ， 如 代码 清单 4-48 所 示 。 

















代码 清单 4-48 ”为 映射 赋值 

















// 创建 一 个 空 映射 ， 用 来 存储 颜色 以 及 颜色 对 应 的 十 六 进 制 代码 


colors := map[string]string{} 








// 将 Red 的 代码 加 入 到 映射 
Colors["Red"] = "#da1337"” 





可 以 通过 声明 一 个 未 初始 化 的 映射 来 创建 一 个 值 为 nil 的 映射 〈 称 
为 nil 映射 ) 。nil 映射 不 能 用 于 存储 键 值 对 ， 人 否则 ， 会 产生 一 个 语言 
运行 时 错误 ， 如 代码 清单 4-49 所 示 。 

















代码 清单 4-49 对 nil 映射 赋值 时 的 语言 运行 时 错误 


// 通过 声明 映射 创建 一 个 nil 映 射 


var colors map[string]string 





// 将 Red 的 代码 加 入 到 映射 
Colors["Red"] = "#da1337"” 


Runtime Error: 
panic: runtime error: assignment to entry in nil map 





测试 映射 里 是 否 存在 茶 个 键 是 映射 的 一 个 重要 操作 。 这 个 操作 人 允许 
用 户 与 一 些 逻 辑 来 确定 是 否 完成 了 茶 个 操作 或 者 是 否 在 映射 里 缓存 了 特 
定数 据 。 这 个 操作 也 可 以 用 来 比较 两 个 映射 ， 来 确定 哪些 键 值 对 互相 匹 
配 ， 哪 些 键 值 对 不 匹配 。 


从 映射 取 值 时 有 两 个 选择 。 第 一 个 选择 是 ， 可 以 同时 获得 值 ， 以 及 
一 个 表示 这 个 键 是 否 存 在 的 标志 ， 如 代码 清单 4-50 所 示 。 


代码 清单 4-50 ”从 映射 获取 值 并 判断 键 是 否 存 在 














// 获取 键 Blue 对 应 的 值 


value, exists := colors["Blue"] 








// 这 个 键 存在 吗 ? 


if exists { 
fmt.Println(value) 
} 








另 一 个 选择 是 ， 只 返回 键 对 应 的 值 ， 然 后 通过 判断 这 个 值 是 不 是 零 
值 来 确定 键 是 否 存 在 ， 如 代码 清单 4-51 所 示 。 








代码 清单 4-51 从 映射 获取 值 ， 并 通过 该 值 判 断 键 是 否 存 在 








// 获取 键 Blue 对 应 的 值 


value := colors[ "Blue"] 


// 这 个 键 存 在 吗 ? 





if value != "" { 
fmt.Println(value) 
} 





在 Go 语言 里 ， 通 过 键 来 索引 映射 时 ， 即 便 这 个 键 不 存在 也 总 会 返 
回 一 个 值 。 在 这 种 情况 下 ， 返 回 的 是 该 值 对 应 的 类 型 的 零 值 。 


迭代 映射 里 的 所 有 值 和 和 代 数组 或 切片 一 样 ， 使 用 关键 字 range ， 
但 对 映射 来 说 ，range 返回 的 不 是 索引 和 值 ， 而 
是 键 值 对 。 











代码 清单 4-52 ”使 用 range 迭代 映射 
































// 创建 一 个 上 映射， 存储 颜色 以 及 颜色 对 应 的 十 六 进 制 代码 
colors := map[string]string{ 

"AliceBlue": "#fef8ff", 

"Coral": "#ff7F58"， 

"DarkGray": "#a9a9a9", 

"ForestGreen": "#228b22",， 


} 
// 显示 映射 里 的 所 有 颜色 


for key, value := range colors { 
fmt.Printf("Key: %s Value: %s\n", key, value) 


} 














如 果 想 把 一 个 键 值 对 从 映射 里 删除 ， 就 使 用 内 置 的 delete 函数 ， 
如 代码 清单 4-53 所 示 。 














代码 清单 4-53 ”从 映射 中 删除 一 项 

















// 删除 键 为 Coral 的 键 值 对 


delete(colors, "Coral") 





// 显示 映射 里 的 所 有 颜色 








for key, value := range colors { 
fmt.Printf("Key: %s Value: %s\n", key, value) 


} 








这 次 在 迭代 映射 时 ， 颜 色 Coral 不 会 显示 在 屏幕 上 。 
4.3.4 在 函数 间 传 递 映射 
在 函数 间 传 递 映射 并 不 会 制造 出 该 映射 的 一 个 副本 。 实 际 上 ， 当 传 


递 喘 射 给 一 个 函数 ， 并 对 这 个 映射 做 了 修改 时 ， 所 有 对 这 个 映射 的 引用 
都 会 察觉 到 这 个 修改 ， 如 代码 清 蛙 4-54 所 示 。 


代码 清单 4-54 在 函数 间 传 递 映 射 


























func main() { 
// 创建 一 个 映射 ， 存 储 颜色 以 及 颜色 对 应 的 十 六 进 制 代码 
colors := map[string]string{ 
"AliceBlue": "#foOf8ff", 
"Coral": "#ff7F58"， 
"DarkGray": "#a9a9a9",， 
"ForestGreen": "#228b22"， 
} 


// 显示 映射 里 的 所 有 颜色 
for key, value := range colors { 
fmt.Printf("Key: %s Value: %s\n", key, value) 



































} 
// 调用 函数 来 移 除 指定 的 键 


removeColor(colors, "Coral") 


























// 显示 映射 里 的 所 有 颜色 
for key, value := range colors { 
fmt.Printf("Key: %s Value: %s\n", key, value) 











} 
} 


// removeColor 将 指定 映射 里 的 键 删 除 


func removeColor(colors map[stringl]string, key string) { 


delete(colors, key) 
} 





如 果 运 行 这 个 程序 ， 会 得 到 代码 清单 4-55 所 示 的 输出 。 
代码 清单 4-55 ”代码 清单 4-54 的 输出 








: AliceBlue Value: #FQOF8FF 

: Coral Value: #FF7F50 

: DarkGray Value: #A9A9A9 

: ForestGreen Value: #228B22 


: AliceBlue Value: #FOF8FF 


: DarkGray Value: #A9A9A9 
: ForestGreen Value: #228B22 





可 以 看 到 ， 在 调用 了 removeColor 之 后 ，main 函数 里 引用 的 映射 
0 颜色 了 。 这 个 特性 和 切片 类 似 ， 保 证 可 以 用 很 小 的 成 本 
; | 映 后 。 


4.4 小 结 


。 数组 是 构造 切片 和 映射 的 基石 。 

Go 语言 里 切片 经 常用 来 处 理 数据 的 集合 ， 映 射 用 来 处 理 具有 键 值 
对 结构 的 数据 。 

内 置 函数 make 可 以 创建 切片 和 映射 ， 并 指定 原始 的 长 度 和 容 
ee 映射 字面 量 ， 或 者 使 用 0 
切片 有 容量 限制 |， 个 过 可 以 使用 内 置 的 append 函数 扩展 容量 。 
映射 的 增长 没有 容量 或 者 任何 限制 。 

内 置 函数 len 可 以 用 来 获取 切片 或 者 映射 的 长 度 。 

内 置 函数 cap 只 能 用 于 切片 。 

通过 组 合 ， 可 以 创建 多 维 数 组 和 多 维 切 片 。 也 可 以 使 用 切片 或 者 其 
他 映射 作为 映射 的 值 。 但 是 切片 不 能 用 作 映 射 的 键 。 

将 切片 或 者 映射 传递 给 函数 成 本 很 小 ， 并 且 不 会 复制 底层 的 数据 结 


构 。 














QD 这 种 方法 只 能 用 在 映射 存储 的 值 都 是 非 零 值 的 情况 。 一 一 译 者 注 


第 5 草 G0 语言 的 类 型 系统 
本 章 主要 内 容 


声明 新 的 用 户 定义 的 类 型 

使 用 方法 ， 为 类 型 增加 新 的 行为 
了 解 何 时 使 用 指针 ， 何 时 使 用 值 
通过 接口 实现 多 态 

通过 组 合 来 扩展 或 改变 类 型 
公开 或 者 未 公开 的 标识 符 


Go 语言 是 一 种 静态 类 型 的 编程 语言 。 这 意味 着 ， 编 译 旧 需 要 在 编 
译 时 知晓 程序 里 每 个 值 的 类 型 。 如 果 提 前 知 关 类 型 信息 ， 编 译 器 就 可 以 
确保 程序 合理 地 使 用 值 。 这 有 助 于 减少 潜在 的 内 存 异 常 和 bug， 并 且 使 
编译 器 有 机 会 对 代码 进行 一 些 性 能 优化 ， 提 高 执行 效率 。 


值 的 类 型 给 编译 器 提供 两 部 分 信息 : 第 一 部 分 ， 需 要 分 配 多 少 内 存 
给 这 个 值 〈 即 值 的 规模 ) ; 第 二 部 分 ， 这 段 内 存 表示 什么 。 对 于 许多 内 
置 类 型 的 情况 来 说 ， 规 模 和 表示 是 类 型 名 的 一 部 分 。int64 类 型 的 值 需 
要 8 字 节 (64 位，， 表 示 一 个 整数 值 ，float32 类 型 的 值 需要 4 字 节 〈32 
位 )， 表 示 一 个 IEEE-754 定 义 的 二 进 制 浮 点 数 ;，bool 类 型 的 值 需 要 1 字 
节 (8 位 〉， 表 示 布 尔 值 true 和 false 。 


有 些 类 型 的 内 部 表示 与 编译 代码 的 机 顺 的 体系 结构 有 关 。 例 如 ， 根 
气 编 译 所 在 的 机 器 的 体系 结构 ， 一 个 int 值 的 大 小 可 能 是 8 字 节 〈64 
位 ) ， 也 可 能 是 4 字 节 〈32 位 ) 。 还 有 一 些 与 体系 结构 相关 的 类 型 ， 如 
Go 语言 里 的 所 有 引用 类 型 。 好 在 创建 和 使 用 这 些 类 型 的 值 的 时 候 ， 不 
需要 了 解 这 些 与 体系 结构 相关 的 信息 。 但 是 ， 如 果 编 译 器 不 知道 这 些 信 
恩 ， 残 无 法 阻止 用 户 做 一 些 叶 致 程序 受 损 其 至 机 器 故障 的 事情 。 


5.1 用 户 定 义 的 类 型 


Go 语言 允许 用 户 定 义 类 型 。 当 用 户 声 明 一 个 新 类 型 时 ， 这 个 声明 
就 给 编译 器 提供 了 一 个 框架 ， 告 知 必 要 的 内 存 大 小 和 表示 信息 。 声 明 后 
的 类 型 与 内 置 类 型 的 运作 方式 类 似 。Go 语 言 里 声明 用 户 定义 的 类 型 有 




















两 种 方法 。 最 第 用 的 方法 是 使 用 关键 字 struct ， 它 可 以 让 用 户 创建 一 


个 结构 类 型 。 


结构 类 型 通过 组 合 一 系列 固定 且 唯 一 的 字段 来 声明 ， 如 代码 清单 5- 
1 所 示 。 结 构 里 每 个 字段 都 会 用 一 个 已 知 类 型 声明 。 这 个 已 知 类 型 可 以 
征 内 置 类 型 ， 也 可 以 是 其 他 用 户 定义 的 类 型 。 





代码 清单 5-1 声明 一 个 结构 类 型 





81 // user 在 程序 里 定义 一 个 用 户 类 型 
62 type user struct { 

name string 

email string 


ext int 
privileged bool 





在 代码 清单 5-1 中 ， 可 以 看 到 一 个 结构 类 型 的 声明 。 这 个 声明 以 关 
键 字 type 开始 ， 之 后 是 新 类 型 的 名 字 ， 最 后 是 关键 字 struct 。 这 个 结 
构 类 型 有 4 个 字段 ， 每 个 字段 都 基于 一 个 内 置 类 型 。 读 者 可 以 看 到 这 些 
字段 是 如 何 组 合成 一 个 数据 的 结构 的 。 一 旦 声明 了 类 型 (如 代码 清单 5- 
2 所 示 ) ， 就 可 以 使 用 这 个 类 型 创建 值 。 


代码 清单 5-2 使 用 结构 类 型 声明 变量 ， 并 初始 化 为 其 零 什 


69 // 声明 user 类 型 的 变量 
16 var bill user 


在 代码 清单 5-2 的 第 10 行 ， 关 键 字 var 创建 了 类 型 为 user 且 名 
为 bi11 的 变量 。 当 声明 变量 时 ， 这 个 变量 对 应 的 值 总 是 会 被 初始 化 。 
这 个 值 要 么 用 指定 的 值 初始 化 ， 要 么 用 零 值 ( 即 变量 类 型 的 默认 值 ) 做 
初始 化 。 对 数值 类 型 来 说 ， 零 值 是 6 ; 对 字符 串 来 襄 ， 零 值 是 空 字 符 
串 ; 对 布尔 类 型 ， 零 值 是 false 。 对 这 个 例子 里 的 结构 ， 结 构 里 每 个 字 
段 都 会 用 零 值 初始 化 。 


任何 时 候 ， 创 建 一 个 变量 并 初始 化 为 其 零 值 ， 习 惯 是 使 用 关键 
字 var 。 这 种 用 法 是 为 了 更 明确 地 表示 一 个 变量 被 设置 为 零 值 。 如 果 变 
量 被 初始 化 为 某 个 非 零 值 ， 就 配合 结构 字面 量 和 短 变量 声明 操作 符 来 创 




































































建 变量 。 


代码 清单 5-3 展 示 了 如 何 声 明 一 个 user 类 型 的 变量 ， 并 使 用 某 个 非 
零 值 作为 初始 值 。 在 第 13 行 ， 我 们 首先 给 出 了 一 个 变量 名 ， 之 后 是 短 变 
量 声明 操作 符 。 这 个 操作 符 是 冒号 加 一 个 等 号 (:= ) 。 一 个 短 变量 声 
明 操 作 符 在 一 次 操作 中 完成 两 件 事情 : 声明 一 个 变量 ， 并 初始 化 。 短 变 
量 声明 操作 符 会 使 用 右 侧 给 出 的 类 型 信息 作为 声明 变量 的 类 型 。 


代码 清单 5-3 ”使 用 结构 字面 量 来 声明 一 个 结构 类 型 的 变量 


















































12 // 声明 user 类 型 的 变量 ， 并 初始 化 所 有 字段 
13 lisa := usert{ 

name: "Lisa", 

email: "lisaQ@Qemail.com", 


ext: 123， 
privileged: true， 








既然 要 创建 并 初始 化 一 个 结构 类 型 ， 我 们 就 使 用 结构 字面 量 来 完成 
这 个 初始 化 ， 如 代码 清单 5-4 所 示 。 结 构 字面 量 使 用 一 对 大 括号 括 住 内 
部 字段 的 初始 值 。 








代码 清单 5-4 ”使 用 结构 字面 量 创建 结 构 类 型 的 值 





13 usert{ 
name: "Lisa", 
email: "lisaQ@Qemail.com", 
ext: 123， 


privileged: true， 








结构 字面 量 可 以 对 结构 类 型 采用 两 种 形式 。 代 码 清单 5-4 中 使 用 了 
第 一 种 形式 ， 这 种 形 陈 在 不 同行 声明 每 个 字段 的 名 字 以 及 对 应 的 值 。 字 
段 名 与 值 用 冒号 分 隔 ， 每 一 行 以 吉 号 结尾 。 这 种 形式 对 字段 的 声明 顺序 
和 
外。 
































代码 清单 5-5 ”不 使 用 字段 名 ， 包 





Me 


建 结构 类 型 的 值 














12 // 声明 user 类 型 的 变量 


13 lisa := user{"Lisa", "lisa@email.com", 123, true} 





每 个 值 也 可 以 分 别 占 一 行 ， 不 过 习惯 上 这 种 形式 会 写 在 一 行 里 ， 结 
尾 不 需要 逗号 。 这 种 形式 下 ， 值 的 顺序 很 重要 ， 必 须要 和 结构 声明 中 字 
段 的 顺序 一 致 。 当 声明 结构 类 型 时 ， 字 段 的 类 型 并 不 限制 在 内 置 类 型 ， 
也 可 以 使 用 其 他 用 户 定义 的 类 型 ， 如 代码 清单 5-6 所 示 。 


代码 清单 5-6 使 用 其 他 结构 类 型 声明 字段 



























































26 // admin 需 要 一 个 user 类 型 作为 管理 者 ， 并 附加 权限 
21 type admin struct { 

22 person user 

23 level string 

24 } 











代码 清单 5-6 展 示 了 一 个 名 为 admin 的 新 结构 类 型 。 这 个 结构 类 型 
有 一 个 名 为 person 的 user 类 型 的 字段 ， 还 声明 了 一 个 名 为 level 的 
string 字段 。 当 创建 具有 person 这 种 字段 的 结构 类 型 的 变量 时 ， 初 始 
化 用 的 结构 字面 量 会 有 一 些 变化 ， 如 代码 清单 5-7 所 示 。 


代码 清单 5-7 使 用 结构 字面 量 来 创建 字段 的 值 












































26 // 声明 admin 类 型 的 变 
27 fred := admin{ 
person: usert{ 
name: "Lisa", 
email: "lisaQ@Qemail.com", 
ext: 123， 
privileged: true， 


: "super", 





为 了 初始 化 person 字段 ， 我 们 需要 创建 一 个 user 类 型 的 值 。 代 码 
清单 5-7 的 第 28 行 就 是 在 创建 这 个 值 。 这 行 代 码 使 用 结构 字面 量 的 形式 
创建 了 一 个 user 类 型 的 值 ， 并 赋 给 了 person 字段 。 


男 一 种 声明 用 户 定 义 的 类 型 的 方法 是 ， 基 于 一 个 已 有 的 类 型 ， 将 其 








作为 新 类 型 的 类 型 说 明 。 当 需要 一 个 可 以 用 已 有 类 型 表示 的 新 类 型 的 时 
候 ， 这 种 方法 会 非常 好 用 ， 如 代码 清单 5-8 所 示 。 标 准 库 使 用 这 种 声明 
从 内 置 类 型 创建 出 很 多 更 加 明确 的 类 型 ， 并 赋予 更 高 级 的 
功能 。 








代码 清单 5-8 基于 int64 声明 一 个 新 类 型 


type Duration int64 


代码 清单 5-8 展 示 的 是 标准 库 的 time 包 里 的 一 个 类 型 的 声 
明 。Duration 是 一 种 描述 时 间 间 隔 的 类 型 ， 单 位 是 纳 秒 Cns) 。 这 个 
类 型 使 用 内 置 的 int64 类 型 作为 其 表示 。 在 Duration 类 型 的 声明 中 ， 
我 们 把 int64 类 型 叫 作 Duration 的 基础 类 型 。 不 过 ， 虽 然 int64 是 基 
础 类 型 ，Go 并 不 认为 Duration 和 :int64 是 同一 种 类 型 。 这 两 个 类 型 是 
完全 不 同 的 有 区 别 的 类 型 。 


为 了 更 好 地 展示 这 种 区 别 ， 来 看 一 下 代码 清单 5-9 所 示 的 小 程序 。 
这 个 程序 本 里 无 法 通过 编译 。 























代码 清单 5-9 ”给 不 同类 型 的 变量 赋值 会 产生 编译 错误 











package main 


type Duration int64 


func main() { 
var dur Duration 
dur = int64(1666) 
} 





代码 清单 5-9 所 示 的 程序 在 第 03 行 声明 了 Duration 类 型 。 之 后 在 第 
06 行 声明 了 一 个 类 型 为 Duration 的 变量 dur ， 并 使 用 零 值 作为 初 值 。 
之 后 ， 第 7 行 的 代码 会 在 编译 的 时 候 产 生 编译 错误 ， 如 代码 清单 5-10 所 
es 

















代码 清单 5-10 ”实际 产生 的 编译 错误 


























prog.go:7: cannot use int64(1666) (type int64) as type Duration 
in assignment 


| 


编译 器 很 清楚 这 个 程序 的 问题 : 类 型 int64 的 值 不 能 作为 类 型 
Duration 的 值 来 用 。 换 句 话 说， 虽然 int64 类 型 是 基础 类 
型 ，Duration 类 型 依然 是 一 个 独立 的 类 型 。 两 种 不 同类 型 的 值 即便 互 
相 兼 容 ， 也 不 能 互相 赋值 。 编 译 器 不 会 对 不 同类 型 的 值 做 隐 式 转换 。 


5.2 方法 


方法 能 给 用 户 定义 的 类 型 添加 新 的 行为 。 方 法 实际 上 也 是 函数 ， 只 
是 在 声明 时 ， 在 关键 字 func 和 方法 名 之 间 增 加 了 一 个 参数 ， 如 代码 清 
单 5-11 所 示 。 








代码 清单 5-11 listing11.go 











61 // 这 个 示例 程序 展示 如 何 声明 
62 // 并 使 用 方法 


63 package main 





04 

65 :import ( 
66 "fmt" 
67 ) 

08 


69 // user 在 程序 里 定义 一 个 用 户 类 型 
16 type user struct { 


11 name string 
12 email string 
13 } 

14 











15 // notify 使 用 值 接收 者 实现 了 一 个 方法 
16 func (uu user) notify() { 


17 fmt.Printf("Sending User Email To %s<%s>\n", 
18 U.Nname, 

19 u.email) 

20 } 

21 


22 // changeEmail 使 用 指针 接收 者 实现 了 一 个 方法 
23 func (uu *user) changeEmail(email string) { 
24 u.email = email 

25 } 








27 // main 是 应 用 程序 的 入 口 
28 func main() { 























29 // user 类 型 的 值 可 以 用 来 调用 
36 // 使 用 值 接收 者 声明 的 方法 





31 bill := user{"Bill", "bill@email.com"} 
32 bill.notify() 
33 


34 // 指向 user 类 型 值 的 指针 也 可 以 用 来 调用 
35 // 使 用 值 接收 者 声明 的 方法 











36 lisa := &user{"Lisa", "lisa@email.com"} 
37 lisa.notify() 
38 




















39 // user 类 型 的 值 可 以 用 来 调用 
40 // 使 用 指针 接收 者 声明 的 方法 





41 bill.changeEmail("bill@newdomain.com") 
42 bill.notify() 
43 

















44 // 指向 user 类 型 值 的 指针 可 以 用 来 调用 
45 // 使 用 指针 接收 者 声明 的 方法 





46 lisa.changeEmail("lisa@newdomain.com") 
47 lisa.notify() 
48 } 





代码 清单 5-11 的 第 16 行 和 第 23 行 展示 了 两 种 类 型 的 方法 。 关 键 
字 func 和 图 数 名 之 间 的 参数 被 称 作 接收 者 ， 将 函数 与 接收 者 的 类 型 绑 
在 一 起 。 如 果 一 个 函数 有 接收 者 ， 这 个 函数 就 被 称 为 方法 。 当 运行 这 
段 程序 时 ， 会 得 到 代码 清单 5-12 所 示 的 输出 。 











代码 清单 5-12 listing11.go 的 输出 














Sending User Email To Bill<bill@email.com> 
Sending User Email To Lisa<lisaQ@email.com> 


Sending User Email To Bill<bill@newdomain.com> 
Sending User Email To Lisa<lisaQ@comcast.com> 





让 我 们 来 解释 一 下 代码 清单 5-13 所 示 的 程序 都 做 了 什么 。 在 第 10 
该 程序 声明 了 名 为 user 的 结构 类 型 ， 并 声明 了 名 为 notify 的 方 
ye 








代码 清单 5-13 listing11.go: 第 09 行 到 第 20 行 

















69 // user 在 程序 里 定义 一 个 用 户 类 型 
16 type user struct { 
11 name string 


12 email string 











15 // notify 使 用 值 接收 者 实现 了 一 个 方法 
16 func (u user) notify() { 


17 fmt.Printf("Sending User Email To %s<%s>\n", 
18 U.name， 

19 u.email) 

20 } 





Go 语言 里 有 两 种 类 型 的 接收 者 : 值 接收 者 和 指针 接收 者 。 在 代码 
全 使 用 值 接收 者 声明 了 notify 方法 ， 如 代码 清单 5- 
14 所 示 。 








代码 清单 5-14 ”使 用 值 接收 者 声明 一 个 方法 


func (u user) notify() { 


notify 方法 的 接收 者 被 声明 为 user 类 型 的 值 。 如 果 使 用 值 接收 者 
声明 方法 ， 调 用 时 会 使 用 这 个 值 的 一 个 副本 来 执行 。 让 我 们 跳 到 代码 清 
单 5-11 的 第 32 行 来 看 一 下 如 何 调用 notify 方法 ， 如 代码 清单 5-15 所 
全 。 




















代码 清单 5-15 listing11.go: 第 29 行 到 第 32 行 


























// user 类 型 的 值 可 以 用 来 调用 
// 使 用 值 接收 者 声明 的 方法 











bill := user{"Bill", "bill@email.com"} 
bill.notify() 





代码 清单 5-15 展 示 了 如 何 使 用 user 类 型 的 值 来 调用 方法 。 第 31 行 
声明 了 一 个 user 类 型 的 变量 bi11 ， 并 使 用 给 定 的 名 字 和 电子 邮件 地 址 
做 初始 化 。 之 后 在 第 32 行 ， 使 用 变量 bi11 来 调用 notify 方法 ， 如 代码 
清单 5-16 所 示 。 

















代码 清单 5-16 ”使 用 变量 来 调用 方法 


bill.notify() 




















这 个 语法 与 调用 一 个 包 里 的 函数 看 起 来 很 类 似 。 但 在 这 个 例子 
里 ，bil11 不 是 包 名 ， 而 是 变量 名 。 这 段 程序 在 调用 notify 方法 时 ， 使 
人 方法 notify 会 接收 到 bil11 的 值 的 
一 个 副本 。 


ee 也 可 以 使 用 指针 来 调用 使 用 值 接收 者 声明 的 方法 ， 如 代码 清单 5-17 
修 。 





代码 清单 5-17 listing11.go: 第 34 行 到 第 37 行 








// 指向 user 类 型 值 的 指针 也 可 以 用 来 调用 
// 使 用 值 接收 者 声明 的 方法 


lisa := &user{"Lisa", "lisa@email.com"} 











lisa.notify() 





代码 清单 5-17 展 示 了 如 何 使 用 指向 user 类 型 值 的 指针 来 调 
用 notify 方法 。 在 第 36 行 ， 声 明了 一 个 名 为 1isa 的 指针 变量 ， 并 使 用 
给 定 的 名 字 和 电子 邮件 地 址 做 初始 化 。 之 后 在 第 37 行 ， 使 用 这 个 指针 变 
量 来 调用 notify 方法 。 为 了 文 持 这 种 方法 调用 ，Go 语 言 调整 了 指针 的 
En 可 以 认为 Go 语言 执行 了 代码 清单 5-18 所 
HIRTE, 














代码 清单 5-18 Go 在 代码 背后 的 执行 动作 


(*1isa).notify() 


代码 清单 5-18 展 示 了 Go 编译 右 为 了 文 持 这 种 方法 调用 背后 做 的 事 
情 。 指 针 被 解 引用 为 值 ， 这 样 束 符合 了 值 接收 者 的 要 求 。 再 强调 一 
次 ，notify 操作 的 是 一 个 副本 ， 只 不 过 这 次 操作 的 是 从 Lisa 指针 指 问 
的 值 的 副本 。 

也 可 以 使 用 指针 接收 者 声明 方法 ， 如 代码 清单 5-19 所 示 。 


代码 清单 5-19 ”listing11.go: 第 22 行 到 第 25 行 





























22 // changeEmail 使 用 指针 接收 者 实现 了 一 个 方法 





23 func (uu *user) changeEmail(email string) { 
24 u.email = email 


25 } 


代码 清单 5-19 展 示 了 changeEmail 方法 的 声明 。 这 个 方法 使 用 指针 
接收 者 声明 。 这 个 接收 者 的 类 型 是 指向 user 类 型 值 的 指针 ， 而 不 
是 user 类 型 的 值 。 当 调用 使 用 指针 接收 者 声明 的 方法 时 ， 这 个 方法 会 
共享 调用 方法 时 接收 者 所 指 回 的 值 ， 如 代码 清单 5-20 所 示 。 


代码 清单 5-20 listing11.go: 第 36 行 和 第 44 行 到 第 46 行 























lisa := &user{"Lisa", "lisa@email.com"} 

















// 指向 user 类 型 值 的 指针 可 以 用 来 调用 





// 使 用 指针 接收 者 声明 的 方法 


lisa.changeEmail("lisa@newdomain.com") 





在 代码 清单 5-20 中 ， 可 以 看 到 声明 了 1isa 指针 变量 ， 还 有 第 46 行 
使 用 这 个 变量 调用 了 changeEmail 方法 。 一 旦 changeEmail 调用 返 
回 ， 这 个 调用 对 值 做 的 修改 也 会 反映 在 lisa 指针 所 指向 的 值 上 。 这 是 
因为 changeEmail 方法 使 用 了 指针 接收 者 。 总 结 一 下 ， 值 接收 者 使 用 
值 的 副本 来 调用 方法 ， 而 指针 接受 者 使 用 实际 值 来 调用 方法 。 


人 以 使 用 一 个 值 来 调用 使 用 指针 接收 者 声明 的 方法 ， 如 代码 清单 
95-21 有 不 。 











代码 清单 5-21 listing11.go: 第 31 行 和 第 39 行 到 第 41 行 

















bill := user{"Bill", "bill@email.com"} 




















// user 类 型 的 值 可 以 用 来 调 





// 使 用 指针 接收 者 声明 的 方法 


bill.changeEmail("bill@newdomain.com") 





在 代码 清单 5-21 中 可 以 看 到 声明 的 变量 bi11 ， 以 及 之 后 使 用 这 个 
变量 调用 使 用 指针 接收 者 声明 的 changeEmail 方法 。Go 语 言 再 一 次 对 
值 做 了 调整 ， 使 之 符合 函数 的 接收 者 ， 进 行 调 用 ， 如 代码 清单 5-22 所 
加 \o 











代码 清单 5-22 ”Go 在 代码 背后 的 执行 动作 

















(&bill).changeEmail("bill@newdomain.com") 


代码 清单 5-22 展 示 了 Go 编译 占 为 了 文 持 这 种 方法 调用 在 背后 做 的 事 
情 。 在 这 个 例子 里 ， 首 先 引 用 bi1l1 值得 到 一 个 指针 ， 这 样 这 个 指针 就 
能 够 匹配 方法 的 接收 者 类 型 ， 再 进行 调用 。Go 语 言 既 允许 使 用 值 ， 也 
允许 使 用 指针 来 调用 方法 ， 不 必 严 格 符合 接收 者 的 类 型 。 这 个 文 持 非常 
方便 开发 者 编写 程序 。 


应 该 使 用 值 接收 者 ， 还 是 应 该 使 用 指针 接收 者 ， 这 个 问题 有 时 会 比 
较 迷 惑 人 。 可 以 遵从 标准 库 里 一 些 基 本 的 指导 方针 来 做 决定 。 后 面 会 进 


一 步 介绍 这 些 指导 方针 。 


5.3 ”类 型 的 本 质 


在 声明 一 个 新 类 型 之 后 ， 声 明 一 个 该 类 型 的 方法 之 前 ， 需 要 先 回 答 
一 个 问题 : 这 个 类 型 的 本 质 是 什么 。 如 果 给 这 个 类 型 增加 或 者 删除 某 个 
值 ， 是 要 创建 一 个 新 值 ， 还 是 要 更 改 当 前 的 值 ? 如 果 是 要 创建 一 个 新 
值 ， 该 类 型 的 方法 就 使 用 值 接收 者 。 如 果 是 要 修改 当前 值 ， 就 使 用 指针 
接收 者 。 这 个 答案 也 会 影响 程序 内 部 传递 这 个 类 型 的 值 的 方式 : 是 按 值 
做 传递 ， 还 是 按 指 针 做 传递 。 保 持 传 递 的 一 致 性 很 重要 。 这 个 背后 的 原 
人 
质 是 什么 。 


5.3.1 内 置 类 型 


内 置 类 型 是 由 语言 提供 的 一 组 类 型 。 我 们 已 经 见 过 这 些 类 型 分别 
是 数值 类 型 、 字 符 串 类 型 和 布尔 类 型 。 这 些 类 型 本 质 上 是 原始 的 类 型 。 
因此 ， 当 对 这 些 值 进行 增加 或 者 删除 的 时 候 ， 会 创建 一 个 新 值 。 基 于 这 
个 结论 ， 当 把 这 些 类 型 的 值 传递 给 方法 或 者 函数 时 ， 应 该 传递 一 个 对 应 
值 的 副本 。 让 我 们 看 一 下 标准 库 里 使 用 这 些 内 置 类 型 的 值 的 函数 ， 如 代 
码 清单 5-23 所 示 。 









































代码 清单 5-23 ”golang.org/src/strings/strings.go: 第 620 行 到 第 625 行 














626 func Trim(s string, cutset string) string { 
621 if s == "" || cutset == "" { 
622 return s 


623 } 
624 return TrimFunc(s, makeCutsetFunc(cutset)) 


在 代码 清单 5-23 中 ， 可 以 看 到 标准 库 里 strings 包 的 Trim 了 画 
数 。Trim 函数 传 入 一 个 string 类 型 的 值 作 操作 ， 再 传 入 一 个 string 
类 型 的 值 用 于 碍 找 。 之 后 函数 会 返回 一 个 新 的 string 值 作为 操作 结 
果 。 这 个 函数 对 调用 者 原始 的 string 值 的 一 个 副本 做 操作 ， 并 返回 一 
个 新 的 string 值 的 副本 。 字 符 串 (string ) 就 像 整 数 、 浮 点 数 和 布尔 值 
一 样 ， 本 质 上 是 一 种 很 原始 的 数据 值 ， 所 以 在 函数 或 方法 内 外 传递 时 ， 
要 传递 字符 串 的 一 份 副 本 。 


让 我 们 看 一 下 体现 内 置 类 型 具有 的 原始 本 质 的 第 二 个 例子 ， 如 代码 
清单 5-24 所 示 。 




















代码 清单 5-24 golang.org/src/os/env.go: 第 38 行 到 第 44 行 

















38 func isShellSpecialVar(c uint8) bool { 


switch c { 


return true 


return false 





代码 清单 5-24 展 示 了 env 包 里 的 ijsShellSpecialVar 函数 。 这 个 
函数 传 入 了 一 个 int8 类 型 的 值 ， 并 返回 一 个 bool 类 型 的 值 。 注 意 ， 这 
里 的 参数 没有 使 用 指针 来 共享 参数 的 值 或 者 返回 值 。 调 用 者 传 入 了 一 
个 uint8 值 的 副本 ， 并 接受 一 个 返回 值 true 或 者 false 。 


5.3.2 ”引用 类 型 


Go 语言 里 的 引用 类 型 有 如 下 几 个 : 切片 、 映 射 、 通 道 、 接 口 和 函 
数 类 型 。 当 声明 上 述 类 型 的 变量 时 ， 创 建 的 变量 被 称 作 标 头 〈header) 
值 。 从 技术 细 市 上 说 ， 和 字符 串 也 是 一 种 引用 类 型 。 每 个 引用 类 型 创建 的 
标 头 值 是 包含 一 个 指 回 底 层 数据 结构 的 指针 。 每 个 引用 类 型 还 包含 一 组 
独特 的 字段 ， 用 于 管理 底层 数据 结构 。 因 为 标 头 值 是 为 复制 而 设计 的 ， 











所 以 永远 不 需要 共享 一 个 引用 类 型 的 值 。 标 头 值 里 包含 一 个 指针 ， 因 此 
和 本 质 上 就 是 在 共享 底层 数据 
让 我 们 看 一 下 net 包 里 的 类 型 ， 如 代码 清单 5-25 所 示 。 


代码 清单 5-25 ”golang.org/src/net/ip.go: 第 32 行 


32 type IP [J]byte 


代码 清单 5-25 展 示 了 一 个 名 为 IP 的 类 型 ， 这 个 类 型 被 声明 为 字 节 切 
片 。 当 要 围绕 相关 的 内 置 类 型 或 者 引用 类 型 来 声明 用 户 定义 的 行为 时 ， 
直接 基于 已 有 类 型 来 声明 用 户 定义 的 类 型 会 很 好 用 。 编 译 器 只 允许 为 合 
名 的 用 户 定义 的 类 型 声明 方法 ， 如 代码 清单 5-26 所 示 。 


代码 清单 5-26 ”golang.org/src/net/ip.go: 第 329 行 到 第 337 行 























329 func (ip IP) MarshalText() ([]byte, error) { 

336 if len(ip) == 6 { 

331 return [J]Jbyte(""), nil 

332 } 

333 if len(ip) != IPv4len && len(ip) != IPv6len { 


334 return nil, errors.New("invalid IP address") 
335 } 

336 return [J]byte(ip.String()), nil 

337 } 





代码 清单 5-26 里 定义 的 MarshalText 方法 是 用 IP 类 型 的 值 接收 者 
声明 的 。 一 个 值 接收 者 ， 正 像 预 期 的 那样 通过 复制 来 传递 引用 ， 从 而 不 
需要 通过 指针 来 共享 引用 类 型 的 值 。 这 种 传递 方法 也 可 以 应 用 到 函数 或 
者 方法 的 参数 传递 ， 如 代码 清单 5-27 所 示 。 


代码 清单 5-27 ”golang.org/src/net/ip.go: 第 318 行 到 第 325 行 























318 // ipEmptyString 像 ip.String 一 样 ， 





319 // 只 不 过 在 没有 设置 ip 时 会 返回 一 个 空 字 符 串 
3268 func ipEmptyString(ip IP) string { 
321 if len(ip) == 6 { 

322 return "" 

323 } 








324 return ip.String() 
325 } 


在 代码 清单 5-27 里 ， 有 一 个 ipEmptyString 函数 。 这 个 函数 需要 
传 入 一 个 IP 类 型 的 值 。 再 一 次 ， 你 可 以 看 到 调用 者 传 入 的 是 这 个 引用 
类 型 的 值 ， 而 不 是 通过 引用 共享 给 这 个 函数 。 调 用 者 将 引用 类 型 的 值 的 
副本 传 入 这 个 函数 。 这 种 方法 也 适用 于 函数 的 返回 值 。 最 后 要 说 的 是 ， 
引用 类 型 的 值 在 其 他 方面 像 原始 的 数据 类 型 的 值 一 样 对 待 。 


5.3.3 ”结构 类 型 


结构 类 型 可 以 用 来 描述 一 组 数据 值 ， 这 组 值 的 本 质 即 可 以 是 原始 
的 ， 也 可 以 是 非 原始 的 。 如 果 决 定 在 菜 些 东西 需要 删除 或 者 添加 某 个 结 
构 类 型 的 值 时 该 结构 类 型 的 值 不 应 该 被 更 改 ， 那 么 需要 遵守 之 前 提 到 的 
内 置 类 型 和 引用 类 型 的 规范 。 让 我 们 从 标准 库 里 的 一 个 原始 本 质 的 类 型 
的 结构 实现 开始 ， 如 代码 清单 5-28 所 示 。 


代码 清 上 


























5-28 ”golang.org/src/time/time.go: 第 39 行 到 第 55 行 











39 type Time struct { 
// sec 给 出 自 公 元 1 和 
// 开始 的 秒 数 


sec int64 











// nsec 指 定 了 一 秒 内 的 纳 秒 偏 移 ， 
// 这 个 值 是 非 零 值 ， 

// 必须 在 [06，999999999] 范 围 内 
nsec int32 





// 1loc 指 定 了 一 个 Location， 

// 用 于 决定 该 时 间 对 应 的 当地 的 分 、 小 时 、 
// 天 和 年 的 值 

// 只 有 Time 的 零 值 ， 其 loc 的 值 是 nil 

// 这 种 情况 下 ， 认 为 处 于 UTC 时 区 


loc *Location 


























代码 清单 5-28 中 的 Time 结构 选 自 time 包 。 当 思考 时 间 的 值 时 ， 你 
应 该 意识 到 给 定 的 一 个 时 间 点 的 时 间 是 不 能 修改 的 。 所 以 标准 库 里 也 是 
这 样 实现 Time 类 型 的 。 让 我 们 看 一 下 Now 函数 是 如 何 创建 Time 类 型 的 


值 的 ， 如 代码 清单 5-29 所 示 。 


代码 清单 5-29 ”golang.org/src/time/time.go: 第 781 行 到 第 784 行 
































781 func Now() Time { 
782 sec，nsec := now() 


return Time{sec + unixToInternal, nsec, Local} 





代码 清单 5-29 中 的 代码 展示 了 Now 函数 的 实现 。 这 个 函数 创建 了 一 
个 Time 类 型 的 值 ， 并 给 调用 者 返回 了 Time 值 的 副本 。 这 个 函数 没有 使 
用 指针 来 共享 Time 值 。 之 后 ， 让 我 们 来 看 一 个 Time 类 型 的 方法 ， 如 代 
码 清单 5-30 所 示 。 


AAA 


代码 清单 5-30 golang.org/src/time/time.go: 第 610 行 到 第 622 行 
































616 func (t Time) Add(d Duration) Time { 
t.sec += int64(d / 1e9) 
nsec := int32(t.nsec) + int32(d%1e9) 
if nsec >= 1e9 { 
t.sect+ 
nsec -= 1e9 
} else if nsec < 6 { 


t.sec-- 

nsec += 1e9 
七 .nsec = nsec 
return 七 








代码 清单 5-30 中 的 Add 方法 是 展示 标准 库 如 何 将 Time 类 型 作为 本 质 
是 原始 的 类 型 的 绝 佳 例子 。 这 个 方法 使 用 值 接收 者 ， 并 返回 了 一 个 新 的 
Time 值 。 该 方法 操作 的 是 调用 者 传 入 的 Time 值 的 副本 ， 并 且 给 调用 者 
返回 了 一 个 方法 内 的 Time 值 的 副本 。 至 于 是 使 用 返回 的 值 蔡 换 原来 的 
值 ， 还 是 创建 一 个 新 的 Time 变量 来 保存 结果 ， 是 由 调用 者 决定 的 
月 


大 多 数 情 况 下 ， 结 构 类 型 的 本 质 并 不 是 原始 的 ， 而 古 非 原 始 的 。 这 
种 情况 下 ， 对 这 个 闫 型 的 值 做 增加 或 者 删除 的 操作 应 该 更 改 值 本 身 。 当 
要 修改 值 本 映 时 ， 在 程序 中 其 他 地 方 ， 需 要 使 用 指针 来 共事 这 个 值 。 





让 我 们 看 一 个 由 标准 库 中 实现 的 具有 非 原始 本 质 的 结构 类 型 的 例子 ， 如 
代码 清单 5-31 所 示 。 





AAA 


代码 清单 5-31 ”golang.org/src/os/file_unix.go: 第 15 行 到 第 29 行 




















// File 表 示 一 个 打开 的 文件 描述 符 
type File struct { 
*file 


} 


// file 是 *File 的 实际 表示 
// 额外 的 一 层 结构 保证 没有 哪个 os 的 客户 端 
// 能 够 覆盖 这 些 数 据 。 如 果 有 履 盖 这 些 数据 ， 


























// 可 能 在 变量 终结 时 关闭 错误 的 文件 描述 符 
24 type file struct { 
fd int 
name string 
dirinfo *dirInfo // 除了 目录 结构 ， 此 字段 为 nil 
nepipe int32 // Write 操作 时 遇 到 连续 EPIPE 的 次 数 
} 








可 以 在 代码 清单 5-31 里 看 到 标准 库 中 声明 的 File 类 型 。 这 个 类 型 
的 本 质 是 非 原始 的 。 这 个 类 型 的 值 实际 上 不 能 安全 复制 。 对 内 部 未 公开 
的 类 型 的 注释 ， 解 释 了 不 安全 的 原因 。 因 为 没有 方法 阻止 程序 员 进 行 复 
制 ， 所 以 File 类 型 的 实现 使 用 了 一 个 怠 入 的 指针 ， 指 同一 个 未 公开 的 
类 型 。 本 章 后 面 会 继续 探讨 内 藤 类 型 。 正 是 这 层 额 外 的 内 和 伦 类 型 阻止 了 
复制 。 不 是 所 有 的 结构 类 型 都 需要 或 者 应 该 实现 类 似 的 额外 保护 。 程 序 
Be 并 使 用 这 个 本 质 来 决定 如 何 组 织 类 











i 


让 我 们 看 一 下 Open 函数 的 实现 ， 如 代码 清单 5-32 所 示 。 


代码 清单 5-32 ”golang.org/src/os/file.go: 第 238 行 到 第 240 行 





























238 func Open(name string) (file *File, err error) { 
239 return OpenFile(name, O_ RDONLY, ©) 


246 } 





代码 清单 5-32 展 示 了 Open 函数 的 实现 ， 调 用 者 得 到 的 是 一 个 指 
和 癌 File 类 型 值 的 指针 。0Open 创建 了 File 类 型 的 值 ， 并 返回 指 问 这 个 


值 的 指针 。 如 果 一 个 创建 用 的 工厂 函数 返回 了 一 个 指针 ， 束 表示 这 个 被 
返回 的 值 的 本 质 是 非 原 始 的 。 


即便 函数 或 者 方法 没有 直接 改变 非 原始 的 值 的 状态 ， 依 旧 应 该 使 用 
共享 的 方式 传递 ， 如 代码 清单 5-33 所 示 。 


代码 清单 5-33 ”golang.org/src/os/file.go: 第 224 行 到 第 232 行 




















224 func (f *File) Chdir() error { 

225 if f == nil { 

226 return ErrInvalid 

227 } 

228 if e := syscall.Fchdir(f.fd); e != nil { 


229 return &PathError{"chdir", f.name, e} 
230 } 

231 return nil 

232 } 





代码 清单 5-33 中 的 Chdir 方法 展示 了 ， 即 使 没有 修改 接收 者 的 值 ， 
依然 是 用 指针 接收 者 来 声明 的 。 因 为 File 类 型 的 值 具备 非 原始 的 本 
质 ， 所 以 总 是 应 该 被 共 译 ， 而 不 是 被 复制 。 


是 使 用 值 接收 者 还 是 指针 接收 者 ， 不 应 该 由 该 方法 是 否 修 改 了 接收 
到 的 值 来 决定 。 这 个 决策 应 该 基于 该 类 型 的 本 质 。 这 条 规则 的 一 个 例外 
是 ， 需 要 让 类 型 值 符合 某 个 接口 的 时 候 ， 即 便 类 型 的 本 质 是 非 原始 本 质 
的 ， 也 可 以 选择 使 用 值 接收 者 声明 方法 。 这 样 做 完全 符合 接口 值 调 用 方 
SS 
| 。 




















5.4 接口 


多 态 是 指 代 码 可 以 根据 类 型 的 具体 实现 采取 不 同行 为 的 能 力 。 如 果 
一 个 类 型 实现 了 某 个 接口 ， 所 有 使 用 这 个 接口 的 地 方 ， 都 可 以 文 持 这 种 
类 型 的 值 。 标 准 库 里 有 很 好 的 例子 ， 如 io 包 里 实现 的 流 式 处 理 接 
口 。io 包 提 供 了 一 组 构造 得 非常 好 的 接口 和 函数 ， 来 让 代码 轻松 支持 
0 
能 








不 过 ， 我 们 的 程序 在 声明 和 实现 接口 时 会 涉及 很 多 细节 。 即 便 实 现 
的 是 已 有 接口 ， 也 需要 了 解 这 些 接口 是 如 何 工 作 的 。 在 探究 接口 如 何 工 
作 以 及 实现 的 细 市 之 前 ， 我 们 先 来 看 一 下 使 用 标准 库 里 的 接口 的 例子 。 


5.4.1 标准 库 


我 们 先 来 看 一 个 示例 程序 ， 这 个 程序 实现 了 流行 程序 curl 的 功能 ， 
如 代码 清单 5-34 所 示 。 














代码 清单 5-34 listing34.go 




















861 // 这 个 示例 程序 展示 如 何 使 用 io.Reader 和 io.Writer 接 口 
862 // 写 一 个 简单 版 本 的 curl 程 序 


63 package main 


04 

865 import ( 

66 "fmt" 

07 "io" 

68 "net/http" 
69 "Os" 

16 ) 

11 





12 // init 在 main 函 数 之 前 调用 
13 func init() { 
14 if len(os.Args) != 2 { 


15 fmt.Println("Usage: ./example2 <url>") 
16 os.Exit(-1) 

17 } 

18 } 

19 





28 // main 是 应 用 程序 的 入 口 
21 func main() { 
22 // 从 Web 服务 器 得 到 响应 











23 r, err := http.Get(os.Args[1]) 
24 if err != nil { 

25 fmt.Println(err) 

26 return 

27 } 

28 

29 // 从 Body 复 制 到 Stdout 

36 io.Copy(os.Stdout, r.Body) 

31 if err := r.Body.Close(); err != nil { 
32 fmt.Println(err) 

33 } 


| | 


代码 清单 5-34 展 示 了 接口 的 能 力 以 及 在 标准 库 里 的 应 用 。 只 用 了 几 
行 代码 我 们 就 通过 两 个 函数 以 及 配套 的 接口 ， 完 成 了 curl 程 序 。 在 第 23 
行 ， 调 用 了 http 包 的 Get 函数 。 在 与 服务 器 成 功 通信 后 ，http .Get 函 
数 会 返回 一 个 http .Response 类 型 的 指针 。http .Response 类 型 包含 
和 的 字段 ， 这 个 字段 是 一 个 io .ReadCloser 接口 类 型 的 





在 第 30 行 ，Body 字段 作为 第 二 个 参数 传 给 io.Copy 也 
数 。io.Copy 函数 的 第 二 个 参数 ， 接 受 一 个 io.Reader 接口 类 型 的 
值 ， 这 个 值 表示 数据 流入 的 源 。Body 字段 实现 了 io.Reader 接口 ， 
3 
为 源 。 


io.Copy 的 第 一 个 参数 是 复制 到 的 目标 ， 这 个 参数 必须 是 一 个 实现 
了 io.Writer 接口 的 值 。 对 于 这 个 目标 ， 我 们 传 入 了 os 包 里 的 一 个 特 
殊 值 Stdout 。 这 个 接口 值 表示 标准 输出 设备 ， 并 且 已 经 实现 了 
io.Writer 接口 。 当 我 们 将 Body 和 stdout 这 两 个 值 传 给 io .Copy 函 
数 后 ， 这 个 函数 会 把 服务 器 的 数据 分 成 小 段 ， 源 源 不 断 地 传 给 终端 窗 
口 ， 直 到 最 后 一 个 片段 读 取 并 写 入 终端 ，io.Copy 函数 才 返 回 。 


io.Copy 函数 可 以 以 这 种 工作 流 的 方式 处 理 很 多 标准 库 里 已 有 的 类 
型 ， 如 代码 清单 5-35 所 示 。 




















代码 清单 5-35 listing35.go 








61 // 这 个 示例 程序 展示 bytes .Buffer 也 可 以 
62 // 用 于 io.Copy 函 数 
63 package main 





64 

65 import ( 
66 "bytes 
67 "fmt" 
68 "IO" 
69 Os 

16 ) 

11 





12 // main 是 应 用 程序 的 入 口 
13 func main() { 
14 var b bytes.Buffer 








16 // 将 字符 串 写 入 Buffer 
17 b.wWrite([]byte("Hello")) 
18 


19 // 使 用 Fprintf 将 字符 串 拼接 到 Buffer 
20 fmt.Fprintf(&b, "World!") 





22 // 将 Buffer 的 内 容 写 到 Stdout 
23 io.Copy(os.stdout，&b ) 
24 } 








代码 清单 5-35 展 示 了 一 个 程序 ， 这 个 程序 使 用 接口 来 拼接 字符 串 ， 
并 将 数据 以 流 的 方式 输出 到 标准 输出 设备 。 在 第 14 行 ， 创 建 了 一 
个 bytes 包 里 的 Buffer 类 型 的 变量 b ， 用 于 缓冲 数据 。 之 后 在 第 17 行 
使 用 Write 方法 将 字符 串 Hello 写 入 这 个 缓冲 区 b 。 第 20 行 ， 调 用 fmt 
包 里 的 Fprintf 函数 ， 将 第 二 个 字符 串 奶 加 到 绥 冲 区 b 里 。 


fmt .Fprintf 函数 接受 一 个 io.Writer 类 型 的 接口 值 作为 其 第 一 
个 参数 。 由 于 bytes .Buffer 类 型 的 指针 实现 了 io.Writer 接口 ， 所 以 
可 以 将 缓存 b 传 入 fmt.Fprintf 函数 ， 并 执行 退 加 操作 。 最 后 ， 在 第 23 
行 ， 再 次 使 用 io.Copy 函数 ， 将 字符 写 到 终端 窗口 。 由 于 
bytes .Buffer 类 型 的 指针 也 实现 了 io.Reader 接口 ，io.Copy 函数 可 
以 用 于 在 终端 窗口 显示 缓冲 区 b 的 内 容 。 


希望 这 两 个 小 程序 展示 出 接口 的 好 处 ， 以 及 标准 库 内 部 是 如 何 使 用 
接口 的 。 下 一 步 ， 让 我 们 看 一 下 实现 接口 的 细节 。 








5.4.2 ”实现 


接口 是 用 来 定义 行为 的 类 型 。 这 些 被 定义 的 行为 不 由 接口 直接 实 
现 ， 而 是 通过 方法 由 用 户 定 义 的 类 型 实现 。 如 果 用 户 定义 的 类 型 实现 了 
某 个 接口 类 型 声明 的 一 组 方法 ， 那 么 这 个 用 户 定 义 的 类 型 的 值 就 可 以 赋 
se 口 类 型 的 值 。 这 个 赋值 会 把 用 户 定义 的 类 型 的 值 存 入 接口 类 型 
和 值 。 


对 接口 值 方法 的 调用 会 执行 接口 值 里 存储 的 用 户 定义 的 类 型 的 值 对 
应 的 方法 。 因 为 任何 用 户 定义 的 类 型 都 可 以 实现 任何 接口 ， 所 以 对 接口 
值 方法 的 调用 自然 就 是 一 种 多 态 。 在 这 个 关系 里 ， 用 户 定义 的 类 型 通常 
叫 作 实体 类 型 ， 原 因 是 如 果 离 开 内 部 存储 的 用 户 定 义 的 类 型 的 值 的 实 








现 ， 接 口 值 并 没有 具体 的 行为 。 


并 不 是 所 有 值 都 完全 等 同 ， 用 户 定 义 的 类 型 的 值 或 者 指针 要 满足 接 
口 的 实现 ， 需 要 遵守 一 些 规则 。 这 些 规 则 在 5.4.3 市 介绍 方法 集 时 有 详细 
说 明 。 探 寻 方 法 集 的 细 市 之 前 ， 了 解 接 口 类 型 值 大 概 的 形式 以 及 用 户 定 
义 的 类 型 的 值 是 如 何 存 入 接口 的 ， 会 有 很 多 帮助 。 


图 5-1 展 示 了 在 user 类 型 值 赋值 后 接口 变量 的 值 的 内 部 布局 。 接 口 
值 是 一 个 两 个 字 长 度 的 数据 结构 ， 第 一 个 字 包 含 一 个 指 回 内 部 表 的 指 
针 。 这 个 内 部 表 叫 作 iTable， 包 含 了 所 存储 的 值 的 类 型 信息 。iTable 包 含 
了 已 存储 的 值 的 类 型 信息 以 及 与 这 个 值 相 关联 的 一 组 方法 。 第 二 个 字 是 
一 个 指向 所 存储 值 的 指针 。 将 类 型 信息 和 指针 组 合 在 一 起 ， 就 将 这 两 个 
值 组 成 了 一 种 特殊 的 关系 。 











var n notifier 


notifier 五 = User{"Bill")} 
接口 值 iTable 


iTable 
的 地 址 


存储 的 值 


USer 


值 的 地 址 








图 5-1 实体 值 赋值 后 接口 值 的 简 图 
图 5-2 展 示 了 一 个 指针 赋值 给 接口 之 后 发 生 的 变化 。 在 这 种 情况 


里 ， 类 型 信息 会 存储 一 个 指 同 保 存 的 类 型 的 指针 ， 而 接口 值 第 二 个 字 依 
旧 保 存 指 问 实体 值 的 指针 。 























var nm 党 丰 长 下 在 王后 下 


notifier ti = CMSer "BELE'.Y 
接口 值 iTable 


0 *USer 的 类 型 


存储 的 值 








图 5-2 ”实体 指针 赋值 后 接口 值 的 简 图 








5.4.3 ”方法 集 





方法 集 定 义 了 接口 的 接受 规则 。 看 一 下 代码 清单 5-36 所 示 的 代 
码 ， 有 助 于 理解 方法 集 在 接口 中 的 重要 角色 。 








代码 清单 5-36 listing36.go 











Dl 





61 // 这 个 示例 程序 展示 Go 语言 里 如 何 使 用 接 
62 package main 





03 

64 import ( 
065 "fmt" 
66 ) 

07 


68 // notifier 是 一 个 定义 了 

69 // 通知 类 行为 的 接口 

16 type notifier interface { 
11 notify() 

12 } 


14 // user 在 程序 里 定义 一 个 用 户 类 型 
15 type user struct { 


16 name string 
17 email string 
18 } 

19 








28 // notify 是 使 用 指针 接收 者 实现 的 方法 
21 func (u *user) notify() { 





22 fmt.Printf("Sending user email to %s<%s>\n", 
23 U.name， 

24 u.email) 

25 } 

26 





27 // main 是 应 用 程序 的 入 口 
28 func main() { 
29 // 创建 一 个 user 类 型 的 值 ， 并 发 送 通知 























36 U := User{"Bill", "bill@email.com"} 

31 

32 sendNotification(u) 

33 

34 // ./listing36.go:32: 不 能 将 u (类 型 是 user) 作为 

35 // sendNotification 的 参数 类 型 notifier: 
36 // “user 类 型 并 没有 实现 notifier 

37 // (notify 方 法 使 用 指针 接收 者 声明 ) 
38 } 

39 





46 // sendNotification 接 受 一 个 实现 了 notifier 接 口 的 值 
41 // 并 发 送 通 知 


42 func sendNotification(n notifier) { 


43 n.notify() 
44 } 


代码 清单 5-36 中 的 程序 昌 然 看 起 来 没 问题 ， 但 实际 上 却 无 法 通过 纺 
译 。 在 第 10 行 中 ， 声 明了 一 个 名 为 notifier 的 接口 ， 包 含 一 个 名 
为 notify 的 方法 。 第 15 行 中 ， 声 明了 名 为 user 的 实体 类 型 ， 并 通过 第 
21 行 中 的 方法 声明 实现 了 notifier 接口 。 这 个 方法 是 使 用 user 类 型 的 
指针 接收 者 实现 的 。 














代码 清单 5-37 listing36.go: 第 40 行 到 第 44 行 














46 // sendNotification 接 受 一 个 实现 了 notifier 接 
41 // 并 发 送 通 知 


42 func sendNotification(n notifier) { 




















43 n.notify() 
44 } 





在 代码 清单 5-37 的 第 42 行 ， 声 明了 一 个 名 为 sendNotification 的 
函数 。 这 个 函数 接收 一 个 notifier 接口 类 型 的 值 。 之 后 ， 使 用 这 个 接 
口 值 来 调用 notify 方法 。 任 何 一 个 实现 了 notifier 接口 的 值 都 可 以 传 
入 sendNotification 函数 。 现 在 让 我 们 来 看 一 下 main 函数 ， 如 代码 
清单 5-38 所 示 。 














代码 清单 5-38 listing36.go: 第 28 行 到 第 38 行 











28 func main() { 
// 创建 一 个 user 类 型 的 值 ， 并 发 送 通知 


U := User{"Bill", "bill@email.com"} 








sendNotification(u) 





./listing36.g0:32: 不 能 将 u (类 型 是 user) 作为 
sendNotification 的 参数 类 型 notifier: 
user 类 型 并 没有 实现 notifier 








(notify 方 法 使 用 指针 接收 者 声明 ) 








在 main 函数 里 ， 代 人 码 清 单 5-38 的 第 30 行 ， 创 建 了 一 个 user 实体 类 
型 的 值 ， 并 将 其 赋值 给 变量 u。 之 后 在 第 32 行 将 u 的 值 传 


入 sendNotification 函数 。 不 过 ， 调 用 sendNotification 的 结果 是 
产生 了 一 个 编译 错误 ， 如 代码 清单 5-39 所 示 。 


代码 清单 5-39 将 user 类 型 的 值 存 入 接口 值 时 产生 的 编译 错误 


























./1listing36.go:32: 不 能 将 u (类 型 是 user ) 作为 sendNotification 的 参数 类 型 notifie 





user 类 型 并 没有 实现 notifier (notify 方 法 使 用 指针 接收 者 声明 ) 














既然 user 类 型 已 经 在 第 21 行 实现 了 notify 方法 ， 为 什么 这 里 还 是 
产生 了 编译 错误 呢 ? 让 我 们 再 来 看 一 下 那 段 代码 ， 如 代码 清单 5-40 所 
A 








代码 清单 5-40 ”listing36.go: 第 08 行 到 第 12 行 ， 第 21 行 到 第 25 行 











// notifier 是 一 个 定义 了 

// 通知 类 行为 的 接口 

type notifier interface { 
notify() 


} 


func (u *user) notify() { 
fmt.Printf("Sending user email to %s<%s>\n", 
u.name, 





代码 清单 5-40 展 示 了 接口 是 如 何 实现 的 ， 而 编译 需 告 诉 我 们 usenr 
类 型 的 值 并 没有 实现 这 个 接口 。 如 有 果 仔 细 看 一 下 编译 融和 输出 的 消 轧 ， 其 
实 编译 器 已 经 说 明了 原因 ， 如 代码 清单 5-41 所 示 。 


代码 清单 5-41 进一步 查看 编译 器 错误 


(notify method has pointer receiver) 


要 了 解 用 指针 接收 者 来 实现 接口 时 为 什么 user 类 型 的 值 无 法 实现 
该 接口 ， 需 要 先 了 解 方法 集 。 方 法 集 定义 了 一 组 关联 到 给 定 类 型 的 值 
或 者 指针 的 方法 。 定 义 方法 时 使 用 的 接收 者 的 类 型 决定 了 这 个 方法 是 关 
联 到 值 ， 还 是 关联 到 指针 ， 还 是 两 个 都 关联 。 















































让 我 们 先 解释 一 下 Go 语言 规范 里 定义 的 方法 集 的 规则 ， 如 代码 清 
单 5-42 所 示 。 























代码 清单 5-42 ”规范 里 描述 的 方法 集 








Methods Receivers 


(t T) and (t *T) 





代码 清单 5-42 展 示 了 规范 里 对 方法 集 的 描述 。 描 述 中 说 到 ，T 类 型 
的 值 的 方法 集 只 包含 值 接收 者 声明 的 方法 。 而 指向 T 类 型 的 指针 的 方法 
集 既 包 含 值 接收 者 声明 的 方法 ， 也 包含 指针 接收 者 声明 的 方法 。 从 值 的 
角度 看 这 些 规则 ， 会 显得 很 复杂 。 让 我 们 从 接收 者 的 角度 来 看 一 下 这 些 
规则 ， 如 代码 清单 5-43 所 示 。 














代码 清单 5-43 ”从 接收 者 类 型 的 角度 来 看 方法 集 




















Methods Receivers Values 





代码 清单 5-43 展 示 了 同样 的 规则 ， 只 不 过 换 成 了 接收 者 的 视角 。 这 
个 规则 说 ， 如 果 使 用 指针 接收 者 来 实现 一 个 接口 ， 那 么 只 有 指向 那个 类 
型 的 指针 才能 够 实现 对 应 的 接口 。 如 果 使 用 值 接收 者 来 实现 一 个 接口 ， 
那么 那个 类 型 的 值 和 指针 都 能 够 实现 对 应 的 接口 。 现 在 再 看 一 下 代码 清 
0 
外。 

















代码 清单 5-44 listing36.go: 第 28 行 到 第 38 行 




















28 func main() { 
29 // 使 用 user 类 型 创建 一 个 值 ， 并 发 送 通 知 








36 U := User{"Bill", "bill@email.com"} 

31 

32 sendNotification(u) 

33 

34 // ./listing36.go:32: 不 能 将 u (类 型 是 user) 作为 








35 // sendNotification 的 参数 类 型 notifier: 


36 // user 类 型 并 没有 实现 notifier 
37 // (notify 方 法 使 用 指针 接收 者 声明 ) 
38 } 











我 们 使 用 指针 接收 者 实现 了 接口 ， 但 是 试图 将 user 类 型 的 值 传 给 
sendNotification 方法 。 代 码 清单 5-44 的 第 30 行 和 第 32 行 清晰 地 展示 
了 这 个 问题 。 但 是 ， 如 果 传 递 的 是 user 值 的 地 址 ， 整 个 程序 就 能 通过 
编译 ， 并 且 能 够 工作 了 ， 如 代码 清单 5-45 所 示 。 


代码 清单 5-45 ”listing36.go: 第 28 行 到 第 35 行 











28 func main() { 
// 使 用 user 类 型 创建 一 个 值 ， 并 发 送 通 知 


U := User{"Bill", "bill@email.com"} 








sendNotification(&u) 

















// 传 入 地 址 ， 不 再 

















在 代码 清单 5-45 里 ， 这 个 程序 终于 可 以 编译 并 且 运 行 。 因 为 使 用 指 
针 接 收 者 实现 的 接口 ， 只 有 user 类 型 的 指针 可 以 传 给 
sendNotification 函数 。 


现在 的 问题 是 ， 为 什么 会 有 这 种 限制 ? 事实 上 ， 编 译 嚣 并 不 是 总 能 
自动 获得 一 个 值 的 地 址 ， 如 代码 清单 5-46 所 示 。 








代码 清单 5-46 listing46.go 








81 // 这 个 示例 程序 展示 不 是 总 能 
862 // 获取 值 的 地 址 


63 package main 








65 import "fmt" 


67 // duration 是 一 个 基于 int 类 型 的 类 型 
68 type duration int 








16 // 使 用 更 可 读 的 方式 格式 化 duration 值 
11 func (d *duration) pretty() string { 
12 return fmt.Sprintf("Duration: %d", *d) 





15 // main 古 应 用 程序 的 入 口 
16 func main() { 
17 duration(42).pretty() 











19 // ./1listing46.go:17: 不 能 通过 指针 调用 duration(42) 的 方法 











26 // ./listing46.go:17: 不 能 获取 duration(42) 的 地 址 





代码 清单 5-46 所 示 的 代码 试图 获取 duration 类 型 的 值 的 地 址 ， 但 是 获 
取 不 到 。 这 展示 了 不 能 总 是 获得 值 的 地 址 的 一 种 情况 。 让 我 们 再 看 一 下 
方法 集 的 规则 ， 如 代码 清单 5-47 所 示 。 











代码 清单 5-47 再 看 一 下 方法 集 的 规则 





Methods Receivers 


(t T) and (t *T) 


Values 





因为 不 是 总 能 获取 一 个 值 的 地 址 ， 所 以 值 的 方法 集 只 包括 了 使 用 值 
接收 者 实现 的 方法 。 


5.4.4 多 态 


现在 了 解 了 接口 和 方法 集 背 后 的 机 制 ， 最 后 来 看 一 个 展示 接口 的 多 
态 行为 的 例子 ， 如 代码 清单 5-48 所 示 。 











代码 清单 5-48 listing48.go 

















61 // 这 个 示例 程序 使 用 接口 展示 多 态 行为 
62 package main 

03 

64 import ( 

65 "fmt" 








66 
87 
68 
69 
106 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 


) 


// notifier 是 一 个 定义 了 
// 通知 类 行为 的 接口 


type notifier interface { 


} 


notify() 


// user 在 程序 里 定义 一 个 用 户 类 型 
type user struct { 


} 


name string 
email string 


// notify 使 用 指针 接收 者 实现 了 notifier 接 口 
func (u *user) notify() { 


} 








fmt.Printf("Sending user email to %s<%s>\n", 
u.name, 
u.email) 


// admin 定 义 了 程序 里 的 管理 员 
type admin struct { 


} 














name string 
email string 





// notify 使 用 指针 接收 者 实现 了 notifier 接 口 
func (a *admin) notify() { 


} 





fmt.Printf("Sending admin email to %s<%s>\n", 
a.name, 
a.email) 





// main 是 应 用 程序 的 入 口 


func main() { 


} 








// 创建 一 个 user 值 并 传 给 sendNotification 
bill := user{"Bill", "bill@email.com"} 
sendNotification(&bill) 





// 创建 一 个 admin 值 并 传 给 sendNotification 
lisa := admin{"Lisa", "lisa@email.com"} 
sendNotification(&]isa) 





// sendNotification 接 受 一 个 实现 了 notifier 接 口 的 值 
// 并 发 送 通 知 





53 func sendNotification(n notifier) { 
54 n.notify() 
55 } 











在 代码 清单 5-48 中 ， 我 们 有 了 一 个 展示 接口 的 多 态 行 为 的 例子 。 在 
第 10 行 ， 我 们 声明 了 和 之 前 代码 清单 中 一 样 的 notifier 接口 。 之 后 第 
15 行 到 第 25 行 ， 我 们 声明 了 一 个 名 为 user 的 结构 ， 并 使 用 指针 接收 者 
实现 了 notifier 接口 。 在 第 28 行 到 第 38 行 ， 我 们 声明 了 一 个 名 
为 admin 的 结构 ， 用 同样 的 形式 实现 了 notifier 接口 。 现 在 ， 有 两 个 
实体 类 型 实现 了 notifier 接口 。 


在 第 53 行 中 ， 我 们 再 次 声明 了 多 态 函 数 sendNotification ， 这 个 
函数 接受 一 个 实现 了 notifier 接口 的 值 作 为 参数 。 既 然 任意 一 个 实体 
类 型 都 能 实现 该 接口 ， 那 么 这 个 函数 可 以 针对 任意 实体 类 型 的 值 来 执 
I 方法 。 因 此 ， 这 个 函数 就 能 提供 多 态 的 行为 ， 如 代码 清单 
5-49 所 不 。 








代码 清单 5-49 listing48.go: 第 40 行 到 第 49 行 




















46 // main 是 应 用 程序 的 入 口 

41 func main() { 
// 创建 一 个 user 值 并 传 给 sendNotification 
bill := user{"Bill", "bill@email.com"} 
sendNotification(&bill) 











// 创建 一 个 admin 值 并 传 给 sendNotification 
lisa := admin{"Lisa", "lisa@email.com"} 
sendNotification(&]isa) 











最 后 ， 可 以 在 代码 清单 5-49 中 看 到 这 种 多 态 的 行为 。main 函数 的 
第 43 行 创建 了 一 个 user 类 型 的 值 ， 并 在 第 44 行 将 该 值 的 地 址 传 给 了 
sendNotification 函数 。 这 最 终 会 导致 执行 user 类 型 声明 的 notify 
方法 。 之 后 ， 在 第 47 行 和 第 48 行 ， 我 们 对 admin 类 型 的 值 做 了 同样 的 事 
情 。 最 终 ， 因 为 sendNotification 接受 notifier 类 型 的 接口 值 ， 所 
以 这 个 函数 可 以 同时 执行 user 和 admin 实现 的 行为 。 


5.5 ” 般 入 类 型 


Go 语言 允许 用 户 扩 展 或 者 修改 已 有 类 型 的 行为 。 这 个 功能 对 代码 
复 用 很 重要 ， 在 修改 已 有 类 型 以 符合 新 类 型 的 时 候 也 很 重要 。 这 个 功能 
是 通过 髓 入 类 型 (type embedding) 完成 鸭 。 肉 入 类 型 是 将 已 有 的 类 型 
直接 声明 在 新 的 结构 类 型 里 。 被 花 入 的 类 型 被 称 为 新 的 外 部 类 型 的 内 部 


类 型 。 


通过 租 入 类 型 ， 与 内 部 类 型 相关 的 标识 符 会 提升 到 外 部 类 型 上 。 这 
些 被 提升 的 标识 符 就 像 直接 声明 在 外 部 类 型 里 的 标识 符 一 样 ， 也 是 外 部 
类 型 的 一 部 分 。 这 样 外 部 类 型 束 组 合 了 内 部 类 型 包含 的 所 有 属性 ， 并 且 
可 以 添加 新 的 字段 和 方法 。 外 部 类 型 也 可 以 通过 声明 与 内 部 类 型 标识 符 
同名 的 标识 符 来 履 盖 内 部 标识 符 的 字段 或 者 方法 。 这 束 是 扩展 或 者 修改 
已 有 类 型 的 方法 。 


让 我 们 通过 一 个 示例 程序 来 演示 通 入 类 型 的 基本 用 法 ， 如 代码 清单 
5-50 所 示 。 




















代码 清单 5-50 listing50.go 

















861 // 这 个 示例 程序 展示 如 何 将 一 个 类 型 嵌入 兄 一 个 类 型 ， 以 及 
862 // 内 部 类 型 和 外 部 类 型 之 间 的 关系 


63 package main 





04 

65 :import ( 
66 "fmt" 
67 ) 

08 


69 // user 在 程序 里 定义 一 个 用 户 类 型 
16 type user struct { 


11 name string 
12 email string 
13 } 

14 








15 // notify 实 现 了 一 个 可 以 通过 user 类 型 值 的 指针 
16 // 调用 的 方法 
17 func (u *user) notify() { 








18 fmt.Printf("Sending user email to %s<%s>\n", 
19 U.name， 

20 u.email) 

21 } 

22 























23 // admin 代 表 一 个 拥有 权限 的 管理 员 用 户 
24 type admin struct { 
25 user // 嵌入 类 型 

















26 level string 
27 } 





29 // main 是 应 用 程序 的 入 口 
36 func main() { 
31 // 创建 一 个 admin 用 户 














32 ad := admin{ 

33 user: usert{ 

34 name: "john smith", 

35 email: "john@yahoo.com", 
36 }， 

37 level: "super", 

38 } 

39 

40 // 我 们 可 以 直接 访问 内 部 类 型 的 方法 
41 ad.user.notify() 

42 





43 // 内 部 类 型 的 方法 也 被 提升 到 外 部 类 型 
44 ad.notify() 





在 代码 清单 5-50 中 ， 我 们 的 程序 演示 了 如 何 租 入 一 个 类 型 ， 并 访问 
舱 入 类 型 的 标识 符 。 我 们 从 第 10 行 和 第 24 行 中 的 两 个 结构 类 型 的 声明 开 
台 ， 如 代码 清单 5-51 所 示 。 


代码 清单 5-51 listing50.go: 第 09 行 到 第 13 行 ， 第 23 行 到 第 27 行 














// user 在 程序 里 定义 一 个 用 户 类 型 
type user struct { 

name string 

email string 


} 























// admin 代 表 一 个 拥有 权限 的 管理 
24 type admin struct { 
25 user // 嵌入 类 型 
26 level string 
27 




















在 代码 清单 5-51 的 第 10 行 ， 我 们 声明 了 一 个 名 为 user 的 结构 类 
型 。 在 第 24 行 ， 我 们 声明 了 另 一 个 名 为 admin 的 结构 类 型 。 在 声 
明 admin 类 型 的 第 25 行 ， 我 们 将 user 类 型 租 入 admin 类 型 里 。 要 和 伦 入 


一 个 类 型 ， 只 需要 声明 这 个 类 型 的 名 字 就 可 以 了 。 在 第 26 行 ， 我 们 声明 
了 一 个 名 为 level 的 字段 。 注 意 声明 字段 和 嵌入 类 型 在 语法 上 的 不 同 。 


一 旦 我 们 将 user 类 型 租 入 admin ， 我 们 就 可 以 说 user 是 外 部 类 型 
admin 的 内 部 类 型 。 有 了 内 部 类 型 和 外 部 类 型 这 两 个 概念 ， 就 能 更 容易 
地 理解 这 两 种 类 型 之 间 的 关系 。 


代码 清单 5-52 展 示 了 使 用 user 类 型 的 指针 接收 者 声明 名 为 notify 
的 方法 。 这 个 方法 只 是 显示 一 行 友 好 的 信息 ， 表 示 将 邮件 发 给 了 特定 的 
用 户 以 及 邮件 地 址 。 
































代码 清单 5-52 ”listing50.go: 第 15 行 到 第 21 行 








15 // notify 实现 了 一 个 可 以 通过 user 类 型 值 的 指针 

16 // 调用 的 方法 

17 func (u *user) notify() { 

18 fmt.Printf("Sending user email to %s<%s>\n", 








19 U.name， 
20 u.email) 
21 } 





现在 ， 让 我 们 来 看 一 下 main 函数 ， 如 代码 清单 5-53 所 示 。 


代码 清单 5-53 ”listing50.go: 第 30 行 到 第 45 行 











36 func main() { 
// 创建 一 个 admin 用 户 
ad := admin{ 
user: usert{ 
name: "john smith", 
email: "john@yahoo.com", 





: "super", 





// 我 们 可 以 直接 访问 内 部 类 型 的 方法 
ad.user.notify() 








// 内 部 类 型 的 方法 也 被 提升 到 外 部 类 型 
ad.notify() 





代码 清单 5-53 中 的 main 函数 展示 了 先入 类 型 背后 的 机 制 。 在 第 32 
行 ， 创 建 了 一 个 admin 类 型 的 值 。 内 部 类 型 的 初始 化 是 用 结构 字面 量 完 
成 的 。 通 过 内 部 类 型 的 名 字 可 以 访问 内 部 类 型 ， 如 代码 清单 5-54 所 示 。 
对 外 部 类 型 来 说 ， 内 部 类 型 总 是 存在 的 。 这 就 意味 着 ， 虽 然 没 有 指定 内 
部 类 型 对 应 的 字段 名 ， 还 是 可 以 使 用 内 部 类 型 的 类 型 名 ， 来 访问 到 内 部 
类 型 的 值 。 
































代码 清单 5-54 ”listing50.go: 第 40 行 到 第 41 行 











在 代码 清单 5-54 中 第 41 行 ， 可 以 看 到 对 notify 方法 的 调用 。 这 个 
调用 是 通过 直接 访问 内 部 类 型 user 来 完成 的 。 这 展示 了 内 部 类 型 是 如 





何 存 在 于 外 部 类 型 内 ， 并 且 总 是 可 访问 的 。 不 过 ， 借 助 内 部 类 型 提 
升 ，notify 方法 也 可 以 直接 通过 ad 变量 来 访问 ， 如 代码 清单 5-55 所 
2 








代码 清单 5-55 ”listing50.go: 第 43 行 到 第 45 行 




















// 内 部 类 型 的 方法 也 被 提升 到 外 部 类 型 
ad.notify() 








代码 清单 5-55 的 第 44 行 中 展示 了 直接 通过 外 部 类 型 的 变量 来 调 
用 notify 方法 。 由 于 内 部 类 型 的 标识 符 提 升 到 了 外 部 类 型 ， 我 们 可 以 
直接 通过 外 部 类 型 的 值 来 访问 内 部 类 型 的 标识 符 。 让 我 们 修改 一 下 这 个 
例子 ， 加 入 一 个 接口 ， 如 代码 清单 5-56 所 示 。 





代码 清单 5-56 listing56.go 














81 // 这 个 示例 程序 展示 如 何 将 嵌入 类 型 应 用 于 接口 


62 package main 








03 

64 import ( 
05 "fmt" 
66 ) 

07 


68 // notifier 是 一 个 定义 了 


// 通知 类 行为 的 接口 


type notifier interface { 


notify() 
} 


// user 在 程序 里 定义 一 个 用 户 类 型 


type user struct 
name string 
email string 


} 


// notify 实 现 了 一 个 可 以 通过 user 类 型 值 


// 调用 的 方法 


{ 














func (u *user) notify() { 











fmt.Printf("Sending user email to %s<%s>\n", 
u.name, 
u.email) 

} 

// admin 代 表 一 个 拥有 权限 的 管理 员 用 户 


























type admin struct { 





user 
level string 

} 

// main 是 应 用 程序 的 入 口 





func main() { 





// 创建 一 个 admin 用 户 


ad := admin{ 


user: usert{ 


Name. 


email: "john@yahoo.com", 


}, 


"john smith", 


level: "super", 


} 











// 给 admin 用 户 发 送 一 个 通知 











// 用 于 实现 接口 的 内 部 类 型 的 方法 ， 被 提升 到 


// 外 部 类 型 


sendNotification(&ad ) 


} 


// sendNotification 接 受 一 个 实现 了 notifier 接 














// 并 发 送 通 知 


func sendNotification(n notifier) { 


n.notify() 
} 











口 的 值 








代码 清单 5-56 所 示 的 示例 程序 的 大 部 分 和 之 前 的 程序 相同 ， 只 有 一 
些小 变化 ， 如 代码 清单 5-57 所 示 。 














代码 清单 5-57 第 08 行 到 第 12 行 ， 第 51 行 到 第 55 行 











// notifier 是 一 个 定义 了 

// 通知 类 行为 的 接口 

type notifier interface { 
notify() 


// sendNotification 接 受 一 个 实现 了 notifier 接 口 的 值 
// 并 发 送 通知 
func sendNotification(n notifier) { 

n.notify() 

















} 





在 代码 清单 5-57 的 第 08 行 ， 声 明了 一 个 notifier 接口 。 之 后 在 第 
53 行 ， 有 一 个 sendNotification 函数 ， 接 受 notifier 类 型 的 接口 的 
值 。 从 代码 可 以 知道 ，user 类 型 之 前 声明 了 名 为 notify`` 的 方法， 该 
方法 使 用 指针 接收 者 实现 了 notifier 接口 。 之 后 ， 让 我 们 看 一 下 main 
函数 的 改动 ， 如 代码 清单 5-58 所 示 。 








代码 清单 5-58 ”listing56.go: 第 35 行 到 第 49 行 

















35 func main() { 
// 创建 一 个 admin 用 户 
ad := admin{ 
user: usert{ 
name: "john smith", 
email: "john@yahoo.com", 





: "super", 








// 给 admin 用 户 发 送 一 个 通知 

// 用 于 实现 接口 的 内 部 类 型 的 方法 ， 被 提升 到 
// 外 部 类 型 

sendNotification(&ad) 























这 里 才 是 事情 变 得 有 趣 的 地 方 。 在 代码 清单 5-58 的 第 37 行 ， 我 们 创 
建 了 一 个 名 为 ad 的 变量 ， 其 类 型 是 外 部 类 型 admin 。 这 个 类 型 内 部 蔡 
入 了 user 类 型 。 之 后 第 48 行 ， 我 们 将 这 个 外 部 类 型 变量 的 地 址 传 给 
sendNotification 函数 。 编 译 器 认为 这 个 指针 实现 了 notifier 接 
口 ， 并 接受 了 这 个 值 的 传递 。 不 过 如 果 看 一 下 整个 示例 程序 ， 就 会 发 现 
admin 类 型 并 没有 实现 这 个 接口 。 


由 于 内 部 类 型 的 提升 ， 内 部 类 型 实现 的 接口 会 目 动 提 升 到 外 部 类 
型 。 这 意味 着 由 于 内 部 类 型 的 实现 ， 外 部 类 型 也 同样 实现 了 这 个 接口 。 
运行 这 个 示例 程序 ， 会 得 到 代码 清单 5-59 所 示 的 输出 。 

















代码 清单 5-59 listing56.go 的 输出 











// notify 实 现 了 一 个 可 以 通过 user 类 型 值 

// 调用 的 方法 

func (u *user) notify() { 
fmt.Printf("Sending user email to %s<%s>\n", 
U.name， 
u.email) 











} 


Sending user email to john smith<john@yahoo.com> 





可 以 在 代码 清单 5-59 中 看 到 内 部 类 型 的 实现 被 调用 。 


如 果 外 部 类 型 并 不 需要 使 用 内 部 类 型 的 实现 ， 而 想 使 用 自己 的 一 套 
实现 ， 该 怎么 办 ? 让 我 们 看 另 一 个 示例 程序 是 如 何 解决 这 个 问题 的 ， 如 
代码 清单 5-60 所 示 。 














代码 清单 5-60 listing60.go 

















62 // 实现 同一 个 接口 时 的 做 法 
63 package main 


04 

865 import ( 
66 "fmt" 
67 ) 

08 


68 // notifier 是 一 个 定义 了 


69 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
46 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 


// 通知 类 行为 的 接口 
type notifier interface { 
notify() 


} 


// user 在 程序 里 定义 一 个 用 户 类 型 
type user struct { 

name string 

email string 


} 


// notify 实 现 了 一 个 可 以 通过 user 类 型 值 
// 调用 的 方法 
func (u *user) notify() { 



































fmt.Printf("Sending user email to %s<%s>\n", 
u.name, 
u.email) 
} 
// admin 代 表 一 个 拥有 权限 的 管理 员 用 户 














type admin struct { 
user 
level string 


} 


// notify 实 现 了 一 个 可 以 通过 admin 类 型 值 
// 调用 的 方法 
func (a *admin) notify() { 




















fmt.Printf("Sending admin email to %s<%s>\n", 
a.name, 
a.email) 
} 
// main 是 应 用 程序 的 入 口 





func main() { 
// 创建 一 个 admin 用 户 
ad := admin{ 
user: usert{ 
name: "john smith", 
email: "john@yahoo.com", 





}, 


level: "super", 


} 


// 给 admin 用 户 发 送 一 个 通知 

// 接口 的 冉 入 的 内 部 类 型 实现 并 没有 提升 到 
// 外 部 类 型 

sendNotification(&ad ) 


























59 // 我 们 可 以 直接 访问 内 部 类 型 的 方法 











66 ad.user.notify() 

61 

62 // 内 部 类 型 的 方法 没有 被 提升 
63 ad.notify() 

64 } 

65 


66 // sendNotification 接 受 一 个 实现 了 notifier 接 口 的 值 
67 // 并 发 送 通知 

















68 func sendNotification(n notifier) { 
69 n.notify() 
76 } 








代码 清单 5-60 所 示 的 示例 程序 的 大 部 分 和 之 前 的 程序 相同 ， 只 有 一 
些小 变化 ， 如 代码 清单 5-61 所 示 。 








代码 清单 5-61 ”listing60.go: 第 35 行 到 第 41 行 


























// notify 实 现 了 一 个 可 以 通过 admin 类 型 值 
// 调用 的 方法 
func (a *admin) notify() { 
fmt.Printf("Sending admin email to %s<%s>\n", 
a.name, 
a.email) 














这 个 示例 程序 为 admin 类 型 增加 了 notifier 接口 的 实现 。 
当 admin 类 型 的 实现 被 调用 时 ， 会 显示 "Sending admin email"。 作 
为 对 比 ，user 类 型 的 实现 被 调用 时 ， 会 显示 "Sending user email" 


O 


main 函数 里 也 有 一 些 变化 ， 如 代码 清单 5-62 所 示 。 


代码 清单 5-62 listing60.go: 第 43 行 到 第 64 行 





























43 // main 是 应 用 程序 的 入 口 

44 func main() { 

45 // 创建 一 个 admin 用 户 

46 ad := admin{ 

47 user: usert{ 

48 name: "john smith", 








49 email: "john@yahoo.com", 


26 }， 

51 level: "super", 
52 } 

53 








54 // 给 admin 用 户 发 送 一 个 通知 
55 // 接口 的 租 入 的 内 部 类 型 实现 并 没有 提升 到 
56 // 外 部 类 型 


























57 sendNotification(&ad) 

58 

59 // 我 们 可 以 直接 访问 内 部 类 型 的 方法 
66 ad.user.notify() 

61 

62 // 内 部 类 型 的 方法 没有 被 提升 

63 ad.notify() 

64 } 





代码 清单 5-62 的 第 46 行 ， 我 们 再 次 创建 了 外 部 类 型 的 变量 ad 。 在 第 
57 行 ， 将 ad 变量 的 地 址 传 给 sendNotification 函数 ， 这 个 指针 实现 





了 接口 所 需要 的 方法 集 。 在 第 60 行 ， 代 码 直 接 访 问 user 内 部 类 型 ， 并 
调用 notify 方法 。 最 后 ， 在 第 63 行 ， 使 用 外 部 类 型 变量 ad 来 调 

用 notify 方法 。 当 查看 这 个 示例 程序 的 输出 《如 代码 清单 5-63 所 示 ) 
时 ， 就 会 看 到 区 别 。 














代码 清 








5-63 listing60.go 的 输出 








Sending admin email to john smith<john@yahoo.com> 
Sending user email to john smith<john@yahoo.com> 


Sending admin email to john smith<john@yahoo.com> 





这 次 我 们 看 到 了 admin 类 型 是 如 何 实现 notifier 接口 的 ， 以 及 如 
何 由 sendNotification 函数 以 及 直接 使 用 外 部 类 型 的 变量 ad 来 执 
行 admin 类 型 实现 的 方法 。 这 表明 ， 如 果 外 部 类 型 实现 了 notify 方 
法 ， 内 部 类 型 的 实现 就 不 会 被 提升 。 不 过 内 部 类 型 的 值 一 直 存 在 ， 因 此 
a De 问 内 部 类 型 的 值 ， 来 调用 没有 被 提升 的 内 部 类 型 实现 
方法 。 


5.6 ”公开 或 未 公开 的 标识 和 从 





要 想 设计 出 好 的 API， 需 要 使 用 某 种 规则 来 控制 声明 后 的 标识 符 的 
可 见 性 。Go 语言 文 持 从 包 里 公开 或 者 隐藏 标识 符 。 通 过 这 个 功能 ， 让 
用 户 能 按照 自己 的 规则 控制 标识 符 的 可 见 性 。 在 第 3 章 讨 论 包 的 时 候 ， 
谈 到 了 如 何 从 一 个 包 引 入 标识 符 到 男 一 个 包 。 有 时 候 ， 你 可 能 不 希望 公 
开 包 里 的 某 个 类 型 、 函 数 或 者 方法 这 样 的 标识 符 。 在 这 种 情况 ， 需 要 一 
种 方法 ， 将 这 些 标 识 符 声 明 为 包 外 不 可 见 ， 这 时 需要 将 这 些 标识 符 声 明 
为 未 公开 的 。 


让 我 们 用 一 个 示例 程序 来 演示 如 何 隐藏 包 里 未 公开 的 标识 符 ， 如 代 
码 清单 5-64 所 示 。 

















代码 清单 5-64 listing64/ 

















counters/counters.go 


61 // counters 包 提供 告 
62 package counters 





跨 
工 
洋 
襄 
到 
沪 
| 

CS 








64 // alertCounter 是 一 个 未 公开 的 类 型 
865 // 这 个 类 型 用 于 保存 告警 计数 
66 type alertCounter int 




















listing64.go 

81 // 这 个 示例 程序 展示 无 法 从 另 一 个 包 里 
82 // 访问 未 公开 的 标识 符 

63 package main 








ee5 import ( 
66 "fmt" 


68 "github.com/goinaction/code/chapter5/listing64/counters" 
69 ) 





11 // main 是 应 用 程序 的 入 口 

12 func main() { 

13 // 创建 一 个 未 公开 的 类 型 的 变量 
14 // 并 将 其 初始 化 为 16 

















15 counter := counters.alertCounter(106) 

16 

17 // ./listing64.go:15: 不 能 引用 未 公开 的 名 字 

18 // counters.alertCounter 

19 // ./listing64.g0:15: 未 定义 : counters.alertCounter 


21 fmt.Printf("Counter: %d\n", counter) 
22 } 





这 个 示例 程序 有 两 个 代码 文件 。 一 个 代码 文件 名 字 为 counters.go， 
保存 在 counters 包 里 ;， 男 一 个 代码 文件 名 字 为 listing64.g0， 守 入 了 
counters 包 。 让 我 们 先 从 counters 包 里 的 代码 开始 ， 如 代码 清单 5-65 
所 示 。 








代码 清单 5-65 ”counters /counters.go 





// counters 包 提供 告警 计数 器 的 功能 
package counters 








// alertCounter 是 一 个 未 公开 的 类 型 

















// 这 个 类 型 用 于 保存 告警 计数 
type alertCounter int 











代码 清单 5-65 展 示 了 只 属于 counters 包 的 代码 。 你 可 能 会 首先 注 
意 到 第 02 行 。 直 到 现在 ， 之 前 所 有 的 示例 程序 都 使 用 了 package main 
， 而 这 里 用 到 的 是 package counters 。 当 要 写 的 代码 属于 某 个 包 时 ， 
好 的 实践 是 使 用 与 代码 所 在 文件 夹 一 样 的 名 字 作 为 包 名 。 所 有 的 Go 工 
具 都 会 利用 这 个 习惯 ， 所 以 最 好 遵守 这 个 好 的 实践 。 


在 counters 包 里 ， 我 们 在 第 06 行 声明 了 唯一 一 个 名 
为 alertCounter 的 标识 符 。 这 个 标识 符 是 一 个 使 用 int 作为 基础 类 型 
的 类 型 。 需 要 注意 的 是 ， 这 是 一 个 未 公开 的 标识 符 。 


当 一 个 标识 符 的 名 字 以 小 写字 母 开 头 时 ， 这 个 标识 符 就 是 未 公开 
的 ， 即 包 外 的 代码 不 可 见 。 如 果 一 个 标识 符 以 大 写字 母 开 头 ， 这 个 标识 
符 就 是 公开 的 ， 即 被 包 外 的 代码 可 见 。 让 我 们 看 一 下 导入 这 个 包 的 代 
码 ， 如 代码 清单 5-66 所 示 。 














代码 清单 5-66 listing64.go 











61 // 这 个 示例 程序 展示 无 法 从 另 一 个 包 里 
82 // 访问 未 公开 的 标识 符 

63 package main 

04 

65 import ( 





66 "fmt" 


68 "github.com/goinaction/code/chapter5/listing64/counters" 
69 ) 





11 // main 是 应 用 程序 的 入 口 

12 func main() { 

13 // 创建 一 个 未 公开 的 类 型 的 变量 
14 // 并 将 其 初始 化 为 16 














15 counter := counters.alertCounter(16) 

16 

17 // ./listing64.go:15: 不 能 引用 未 公开 的 名 字 

18 // counters.alertCounter 
19 // ./listing64.g0:15: 未 定义 : counters.alertCounter 

20 

21 fmt.Printf("Counter: %d\n", counter) 

22 } 





代码 清单 5-66 中 的 listing64.go 的 代码 在 第 03 行 声明 了 main 包 ， 之 后 
在 第 08 行 导入 了 counters 包 。 在 这 之 后 ， 我 们 跳 到 main 函数 里 的 第 15 
行 ， 如 代码 清单 5-67 所 示 。 








代码 清单 5-67 ”listing64.go: 第 13 到 19 行 





// 创建 一 个 未 公开 的 类 型 的 变量 
// 并 将 其 初始 化 为 16 


counter := counters.alertCounter(16) 








// ./listing64.go:15: 不 能 引用 未 公开 的 名 字 
// counters.alertCounter 
// ./listing64.g0:15: 未 定义 : counters.alertCounter 





在 代码 清单 5-67 的 第 15 行 ， 代 码 试 图 创建 未 公开 的 alertCounter 
类 型 的 值 。 不 过 这 段 代 码 会 造成 第 15 行 展示 的 编译 错误 ， 这 个 编译 错误 
表明 第 15 行 的 代码 无 法 引用 counters.alertCounter 这 个 未 公开 的 标 
识 符 。 这 个 标识 符 是 未 定义 的 。 


由 于 counters 包 里 的 alertCounter 类 型 是 使 用 小 写字 母 声明 
的 ， 所 以 这 个 标识 符 是 未 公开 的 ， 无 法 被 listing64.go 的 代码 访问 。 如 果 
我 们 把 这 个 类 型 改 为 用 大 写字 母 开 头 ， 那 么 就 不 会 产生 编译 器 错误 。 让 
我 们 看 一 下 新 的 示例 程序 ， 如 代码 清单 5-68 所 示 ， 这 个 程序 





在 counters 包 里 实现 了 工厂 函数 。 








代码 清单 5-68 listing68/ 














counters/counters.go 





// counters 包 提供 全 
package counters 








// alertCounter 是 一 个 未 公开 的 类 型 
// 这 个 类 型 用 于 保存 告警 计数 
type alertCounter int 























// New 创 建 并 返回 一 个 未 公开 的 

// alertCounter 类 型 的 值 

func New(value int) alertCounter { 
return alertCounter(value) 





} 


listing68.go 








// 这 个 示例 程序 展示 如 何 访问 男 一 个 包 的 未 公开 的 
// 标识 符 的 值 


package main 





import ( 
"fmt" 


"github.com/goinaction/code/chapter5/listing68/counters" 


) 
// main 是 应 用 程序 的 入 口 


func main() { 
// 使 用 counters 包 公开 的 New 函 数 来 创建 
// 一 个 未 公开 的 类 型 的 变量 


counter := Counters.New(16) 











fmt.Printf("Counter: %d\n", counter) 





这 个 例子 已 经 修改 为 使 用 工厂 函数 来 创建 一 个 未 公开 的 
alertCounter 类 型 的 值 。 让 我 们 先 看 一 下 counters 包 的 代码 ， 如 代 
码 清 单 5-69 所 示 。 





代码 清单 5-69 counters /counters.go 








// counters 包 提供 告警 计数 器 的 功能 
package counters 








64 // alertCounter 是 一 个 未 公开 的 类 型 
// 这 个 类 型 用 于 保存 告警 计数 
type alertCounter int 























// New 创 建 并 返回 一 个 未 公开 的 

// alertCounter 类 型 的 值 

func New(value int) alertCounter { 
return alertCounter(value) 





} 





代码 清单 5-69 展 示 了 我 们 对 counters 包 的 改动 。alertCounter 
类 型 依旧 是 未 公开 的 ， 不 过 现在 在 第 10 行 增加 了 一 个 名 为 New 的 新 函 
数 。 将 工厂 函数 命名 为 New 是 Go 语言 的 一 个 习惯 。 这 个 New 函数 做 了 些 
有 意思 的 事情 : 它 创 建 了 一 个 未 公开 的 类 型 的 值 ， 并 将 这 个 值 返 回 给 调 
用 者 。 让 我 们 看 一 下 listing68.go 的 main 函数 ， 如 代码 清单 5-70 所 示 。 


代码 清单 5-70 listing68.go 














11 // main 是 应 用 程序 的 入 口 
12 func main() { 

13 // 使 用 counters 包 公开 的 New 函 数 来 创建 
14 // 一 个 未 公开 的 类 型 的 变量 





15 counter := Counters.New(16) 

16 

17 fmt.Printf("Counter: %d\n", counter) 
18 } 





在 代码 清单 5-70 的 第 15 行 ， 可 以 看 到 对 counters 包 里 New 函数 的 
调用 。 这 个 New 函数 返回 的 值 被 赋 给 一 个 名 为 counter 的 变量 。 这 个 程 
序 可 以 编译 并 且 运 行 ， 但 为 什么 呢 ? New 函数 返回 的 是 一 个 未 公开 的 
alertCounter 类 型 的 值 ， 而 main 函数 能 够 接受 这 个 值 并 创建 一 个 未 
公开 的 类 型 的 变量 。 


要 让 这 个 行为 可 行 ， 需 要 两 个 理由 。 第 一 ， 公 开 或 者 未 公开 的 标识 
从 ， 不 是 一 个 值 。 第 二 ， 短 变量 声明 操作 符 ， 有 能 力 捕 获 引 用 的 类 型 ， 











并 创建 一 个 未 公开 的 类 型 的 变量 。 永 远 不 能 显 式 创建 一 个 未 公开 的 类 型 
的 变量 ， 不 过 短 变量 声明 操作 符 可 以 这 么 做 。 


让 我 们 看 一 个 新 例子 ， 这 个 例子 展示 了 这 些 可 见 的 规则 是 如 何 影 响 
到 结构 里 的 字段 ， 如 代码 清单 5-71 所 示 。 

















代码 清单 5-71 listing71/ 














entities/entities.go 


// entities 包 包含 系统 中 
// 与 人 有 关 的 类 型 


package entities 


// User 在 程序 里 定义 一 个 用 户 类 型 
type User struct { 

Name string 

email string 


} 

listing71.go 
// 这 个 示例 程序 展示 公开 的 结构 类 型 中 未 公开 的 字段 
// 无 法 直接 访问 


package main 











import ( 
"fmt" 


"github.com/goinaction/code/chapter5/listing71/entities" 
) 


// main 是 应 用 程序 的 入 口 
func main() { 
// 创建 entities 包 中 的 User 类 型 的 值 
u := entities.Usert{ 
Name: "Bill", 
email: "bill@email.com", 











} 








// ./example69.g0:16: 结构 字面 量 中 结构 entities .User 
// 的 字段 email’? 未 知 


fmt.Printf("User: %v\n", u) 





代码 清单 5-71 中 的 代码 有 一 些微 妙 的 变化 。 现 在 我 们 有 一 个 名 
为 entities 的 包 ， 声 明了 名 为 User 的 结构 类 型 ， 如 代码 清单 5-72 所 
示 。 











代码 清 








5-72 entities /entities.go 








// entities 包 包含 系统 中 
// 与 人 有 关 的 类 型 


package entities 


// User 在 程序 里 定义 一 个 用 户 类 型 


type User struct { 
Name string 
email string 





代码 清单 5-72 的 第 06 行 中 的 User 类 型 被 声明 为 公开 的 类 型 。User 
类 型 里 声明 了 两 个 字段 ， 一 个 名 为 Name 的 公开 的 字段 ， 一 个 名 为 email 
的 未 公开 的 字段 。 让 我 们 看 一 下 listing71.go 的 代码 ， 如 代码 清单 5-73 所 
示 。 








代码 清单 5-73 listing71.go 





861 // 这 个 示例 程序 展示 公开 的 结构 类 型 中 未 公开 的 字段 
62 // 无 法 直接 访问 


63 package main 











@5 import ( 
66 "fmt" 


68 "github.com/goinaction/code/chapter5/listing71/entities" 
69 ) 


11 // main 是 程序 的 入 口 
12 func main() { 
13 // 创建 entities 包 中 的 User 类 型 的 值 











14 U := entities.Usert{ 

15 Name: "Bill", 

16 email: "bill@email.com", 

17 } 

18 

19 // ./example69.go:16: 结构 字面 量 中 结构 entities .User 


20 // 的 字段 'email' 未 知 


21 
22 fmt.Printf("User: %v\n", u) 
23 } 





代码 清单 5-73 的 第 08 行 导入 了 entities 包 。 在 第 14 行 声明 了 





entities 包 中 的 公开 的 类 型 User 的 名 为 u 的 变量 ， 并 对 该 字段 做 了 初 
始 化 。 不 过 这 里 有 一 个 问题 。 第 16 行 的 代码 试图 初始 化 未 公开 的 字段 
email ， 所 以 编译 器 抱怨 这 是 个 未 知 的 字段 。 因 为 email 这 个 标识 符 未 
公开 ， 所 以 它 不 能 在 entities 包 外 被 访问 。 


证 我 们 看 最 后 一 个 例子 ， 这 个 例子 展示 了 公开 和 未 公开 的 内 典 关 型 
征 如 何 工 作 的 ， 如 代码 清单 5-74 所 示 。 








代码 清单 5-74 listing74/ 








entities/entities.go 


681 // entities 包 包含 系统 中 
62 // 与 人 有 关 的 类 型 
63 package entities 


65 // user 在 程序 里 定义 一 个 用 户 类 型 
66 type user struct { 











67 Name string 

68 Email string 

69 } 

10 

11 // Admin 在 程序 里 定义 了 管理 员 

12 type Admin struct { 

13 user // 嵌入 的 类 型 是 未 公开 的 
14 Rights int 

15 } 


81 // 这 个 示例 程序 展示 公开 的 结构 类 型 中 如 何 访问 
862 // 未 公开 的 内 购 类 型 的 例子 


63 package main 





04 
865 import ( 
66 "fmt" 
07 


68 "github.com/goinaction/code/chapter5/listing74/entities" 





11 // main 是 应 用 程序 的 入 口 
12 func main() { 
13 // 创建 entities 包 中 的 Admin 类 型 的 值 








14 a := entities.Admini{ 
15 Rights: 16， 

16 } 

17 


18 // 设置 未 公开 的 内 部 类 型 的 
19 // 公开 字段 的 值 


20 a.Name = "Bill" 

21 a.Email = "bill@email.com" 
22 

23 fmt.Printf("User: %v\n", a) 
24 } 





现在 ， 在 代码 清单 5-74 里 ，entities 包 包 含 两 个 结构 类 型 ， 如 代 
码 清单 5-75 所 示 。 














代码 清 








5-75 entities /entities.go 








// entities 包 包含 系统 中 
// 与 人 有 关 的 类 型 


package entities 


// user 在 程序 里 定义 一 个 用 户 类 型 
type user struct { 

Name string 

Email string 


} 


// Admin 在 程序 里 定义 了 管理 员 
type Admin struct { 
user // 骨 入 的 类 型 未 公开 
Rights int 











在 代码 清单 5-75 的 第 06 行 ， 声 明了 一 个 未 公开 的 结构 类 型 user 。 
这 个 类 型 包括 两 个 公开 的 字段 Name 和 Email 。 在 第 12 行 ， 声 明了 一 个 
公开 的 结构 类 型 Admin 。Admin 有 一 个 名 为 Rights 的 公开 的 字段 ， 而 
且 先 入 一 个 未 公开 的 user 类 型 。 让 我 们 看 一 下 listing74.go 的 main 函 


数 ， 如 代码 清单 5-76 所 示 。 








代码 清单 5-76 listing74.go: 第 11 到 24 行 





// main 是 应 用 程序 的 入 口 
func main() { 
// 创建 entities 包 中 的 Admin 类 型 的 值 
a := entities.Admini{ 
Rights: 16， 
} 


// 设置 未 公开 的 内 部 类 型 的 

// 公开 字段 的 值 

a.Name = "Bill" 

a.Email = "bill@email.com" 








fmt.Printf("User: %v\n", a) 





让 我 们 从 代码 清单 5-76 的 第 14 行 的 main 函数 开始 。 这 个 函数 创建 
了 entities 包 中 的 Admin 类 型 的 值 。 由 于 内 部 类 型 user 是 未 公开 的 ， 
这 段 代码 无 法 直接 通过 结构 字面 量 的 方式 初始 化 该 内 部 类 型 。 不 过 ， 即 
便 内 部 类 型 是 未 公开 的 ， 内 部 类 型 里 声明 的 字段 依旧 是 公开 的 。 既 然 内 
部 类 型 的 标识 符 提 升 到 了 外 部 类 型 ， 这 些 公开 的 字段 也 可 以 通过 外 部 类 
型 的 字段 的 值 来 访问 。 


因此 ， 在 第 20 行 和 第 21 行 ， 来 自 示 公开 的 内 部 类 型 的 字段 Name 和 
Email 可 以 通过 外 部 类 型 的 变量 a 被 访问 并 被 初始 化 。 因 为 user 类 型 
是 未 公开 的 ， 所 以 这 里 没有 直接 访问 内 部 类 型 。 





5.7 ”小结 


。 使 用 关键 字 struct 或 者 通过 指定 已 经 存在 的 类 型 ， 可 以 声明 用 户 
定义 的 类 型 。 

。 方法 提供 了 一 种 给 用 户 定 义 的 类 型 增加 行为 的 方式 。 

。 设计 类 型 时 需要 确认 类 型 的 本 质 是 原始 的 ， 还 是 非 原始 的 。 

。 接口 是 声明 了 一 组 行为 并 文 持 多 态 的 类 型 。 





代入 类 型 提供 了 扩展 类 型 的 能 力 ， 而 无 需 使 用 继承 。 
标识 符 要 么 是 从 包 里 公开 的 ， 要 么 是 在 包 里 未 公开 的 。 





第 6 章 ” 并 发 
本 章 主 要 内 容 


。 使 用 goroutine 运 行程 序 
。 检测 并 修正 竞争 状态 
。 利 用 通道 共享 数据 


通常 程序 会 个 编写 为 一 个 顺序 执行 并 完成 一 个 独立 任务 的 代码 。 如 
果 没 有 特别 的 需求 ， 最 好 总 是 这 样 写 代码 ， 因 为 这 种 类 型 的 程序 通常 很 
容易 写 ， 也 很 容易 维护 。 不 过 也 有 一 些 情况 下 ， 并 行 执行 多 个 任务 会 有 
更 大 的 好 处 。 一 个 例子 是 ，Web 服 务 需要 在 各 自 独立 的 套 接 字 
(socket) 上 同时 接收 多 个 数据 请 求 。 每 个 套 接 字 请 求 都 是 独立 的 ， 可 
以 完全 独立 于 其 他 套 接 字 进 行 处 理 。 具 有 并 行 执行 多 个 请 求 的 能 力 可 以 
显著 提高 这 类 系统 的 性 能 。 考 虑 到 这 一 点 ，Go 语 言 的 语法 和 运行 时 直 
接 内 置 了 对 并 发 的 支持 。 


Go 语言 里 的 并 发 指 的 是 能 让 某 个 函数 独立 于 其 他 函数 运行 的 能 
力 。 当 一 个 函数 创建 为 goroutine 时 ，Go 会 将 其 视 为 一 个 独立 的 工作 单 
元 。 这 个 单元 会 被 调度 到 可 用 的 逻辑 处 理 器 上 执行 。Go 语 言 运行 时 的 
调度 器 是 一 个 复杂 的 软件 ， 能 管理 被 创建 的 所 有 goroutine 并 为 其 分 配 执 
行 时 间 。 这 个 调度 器 在 操作 系统 之 上 ， 将 操作 系统 的 线程 与 语言 运行 时 
的 逻辑 处 理 占 绑 定 ， 并 在 逻辑 处 理 嚣 上 运行 goroutine。 调 度 右 在 任何 给 
定 的 时 间 ， 都 会 全 面 控 制 哪个 goroutine 要 在 哪个 逻辑 处 理 器 上 运行 。 


Go 语言 的 并 发 同步 模型 来 自 一 个 叫 作 通信 顺序 进程 

(Communicating Sequential Processes，CSP) 的 范 型 (paradigm) 。 
CSP 是 一 种 消息 传递 模型 ， 通 过 在 goroutine 之 间 传 递 数 据 来 传递 消息 ， 
而 不 是 对 数据 进行 加 锁 来 实现 同步 访问 。 用 于 在 goroutine 之 间 同 步 和 传 
递 数 据 的 关键 数据 类 型 叫 作 通 道 〈channel) 。 对 于 没有 使 用 过 通道 写 
并 发 程序 的 程序 员 来 说 ， 通 道 会 让 他 们 感觉 神奇 而 兴奋 。 项 望 读者 使 用 
后 也 能 有 这 种 感觉 。 使 用 通道 可 以 使 编号 并 发 程序 更 容易 ， 也 能 够 让 并 
发 程序 出 错 更 少 。 


6.1 并 友 与 并 行 

















让 我 们 先 来 学 习 一 下 抽象 程度 较 高 的 概念 : 什么 是 操作 系统 的 线程 
Cthread) 和 进程 (process) 。 这 会 有 助 于 后 面 理解 Go 语言 运行 时 调度 
器 如 何 利 用 操作 系统 来 并 发 运行 goroutine。 当 运行 一 个 应 用 程序 〈 如 一 
个 IDE 或 者 编辑 器 ) 的 时 候 ， 操 作 系统 会 为 这 个 应 用 程序 启动 一 个 进 
程 。 可 以 将 这 个 进程 看 作 一 个 包含 了 应 用 程序 在 运行 中 需要 用 到 和 维护 
的 各 种 资源 的 容器 。 


图 6-1 展 示 了 一 个 包含 所 有 可 能 分 配 的 常用 资源 的 进程 。 这 些 资源 
包括 但 不 限于 内 存 地 址 空间 、 文 件 和 设备 的 句柄 以 及 线程 。 一 个 线程 
是 一 个 执行 空间 ， 这 个 空间 会 被 操作 系统 调度 来 运行 函数 中 所 写 的 代 
码 。 每 个 进程 至 少 包含 一 个 线程 ， 每 个 进程 的 初始 线程 被 称 作 主线 程 
。 因 为 执行 这 个 线程 的 空间 是 应 用 程序 的 本 身 的 空间 ， 所 以 当主 线程 终 
止 时 ， 应 用 程序 也 会 终止 。 操 作 系 统 将 线程 调度 到 某 个 处 理 器 上 运行 ， 
这 个 处 理 器 并 不 一 定 是 进程 所 在 的 处 理 器 。 不 同 操作 系统 使 用 的 线程 调 
0 
时 村山。 




















进程 维护 了 应 用 程序 运行 时 的 内 存 地 址 空间 、 文 件 和 设备 的 句柄 以 及 线程 。 
操作 系统 的 调度 器 决定 哪个 线程 会 获得 给 定 的 CPU 的 运行 时 间 。 
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操作 系统 调度 器 




















图 6-1 ”一 个 运行 的 应 用 程序 的 进程 和 线程 的 简要 描绘 














操作 系统 会 在 物理 处 理 器 上 调度 线程 来 运行 ， 而 Go 语言 的 运行 时 
会 在 逻辑 处 理 器 上 调度 goroutine 来 运行 。 每 个 逻辑 处 理 器 都 分 别 绑 定 到 


单个 操作 系统 线程 。 在 1.5 版 本 @ 上，Go 语 言 的 运行 时 默认 会 为 每 个 可 
用 的 物理 处 理 器 分 配 一 个 逻辑 处 理 器 。 在 1.5 版 本 之 前 的 版 本 中 ， 默 认 
给 整个 应 用 程序 只 分 配 一 个 逻辑 处 理 器 。 这 些 逻 辑 处 理 器 会 用 于 执行 所 
有 被 创建 的 goroutine。 即 便 只 有 一 个 逻辑 处 理 器 ，Go 也 可 以 以 神奇 的 效 
率 和 性 能 ， 并 发 调度 无 数 个 goroutine。 


在 图 6-2 中 ， 可 以 看 到 操作 系统 线程 、 逻 辑 处 理 器 和 本 地 运行 队列 
之 间 的 关系 。 如 果 创 建 一 个 goroutine 并 准备 运行 ， 这 个 goroutine 就 会 被 
放 到 调度 器 的 全 局 运行 队列 中 。 之 后 ， 调 度 器 就 将 这 些 队列 中 的 
goroutine 分 配给 一 个 逻辑 处 理 器 ， 并 放 到 这 个 逻辑 处 理 右 对 应 的 本 地 运 
行 队列 中 。 本 地 运行 队列 中 的 goroutine 会 一 直 等 待 直到 自己 被 分 配 的 逻 
辑 处 理 器 执行 。 











Go 语言 运行 时 会 把 goroutine 调 度 到 逻辑 处 理 器 tine 执 行 了 一 个 阻塞 的 系统 调用 于 
上 运行 。 这 个 逻辑 处 理 器 绑 定 到 唯一 的 操作 系 | 
统 线程 。 当 goroutine 可 以 运行 的 时 候 ， 会 被 放 建 一 个 新 线程 来 运行 这 个 处 理 器 上 提供 的 
入 逻辑 处 理 器 的 执行 队列 中 。 




















被 阻塞 的 
G4 
图 6-2 ”Go 调度 器 如 何 管 理 goroutine 


有 时 ， 正 在 运行 的 goroutine 需 要 执行 一 个 阻塞 的 系统 调用 ， 如 打开 
一 个 文件 。 当 这 类 调用 发 生 时 ， 线 程 和 goroutine 会 从 逻辑 处 理 需 上 分 
离 ， 该 线程 会 继续 阻 压 ， 等 竺 系统 调用 的 返回 。 与 此 同时 ， 这 个 多 和 辑 处 
理 需 就 失去 了 用 来 运行 的 线程 。 所 以 ， 调 度 露 会 创建 一 个 新 线程 ， 并 将 
其 绑 定 到 该 逻辑 处 理 右 上 。 之 后 ， 调 度 圳 会 从 本 地 运行 队列 里 选择 刀 一 
个 goroutine 来 运行 。 一 旦 被 阻塞 的 系统 调用 执行 完成 并 返回 ， 对 应 的 





goroutine 会 放 回 到 本 地 运行 队列 ， 而 之 前 的 线程 会 保存 好 ， 以 便 之 后 可 
以 继续 使 用 。 


如 果 一 个 goroutine 需 要 做 一 个 网 络 MO 调 用 ， 流 程 上 会 有 些 不 一 样 。 
在 这 种 情况 下 ，goroutine 会 和 逻辑 处 理 占 分 离 ， 并 移 到 集成 了 网 络 轮 询 
器 的 运行 时 。 一 旦 该 轮 询 器 指示 茶 个 网 络 读 或 者 与 操作 已 经 就 绪 ， 对 应 
的 goroutine 就 会 重新 分 配 到 逻辑 处 理 器 上 来 完成 操作 。 调 度 器 对 可 以 创 
建 的 馆 辑 处 理 器 的 数量 没有 限制 ， 但 语言 运行 时 默认 限制 每 个 程序 最 多 
创建 10 000 个 线程 。 这 个 限制 值 可 以 通过 调用 runtime/debug 包 的 
SetMaxThreads 方法 来 更 改 。 如 果 程 序 试图 使 用 更 多 的 线程 ， 就 会 崩 


1 员 。 





并 发 《concurrency) 不 是 并 行 (parallelism) 。 并 行 是 让 不 同 的 代 
人 码 片 段 同 时 在 不 同 的 物理 处 理 嚣 上 执行 。 并 行 的 关键 是 同时 做 很 多 事 
情 ， 而 并 发 是 指 同 时 管理 很 多 事情 ， 这 些 事 情 可 能 只 做 了 一 半 就 被 暂停 
去 做 别 的 事情 了 。 在 很 多 情况 下 ， 并 发 的 效果 比 并 行 好 ， 因 为 操作 系统 
和 硬件 的 总 资源 一 般 很 少 ， 但 能 文 持 系统 同时 做 很 多 事情 。 这 种 “使 用 
较 少 的 资源 做 更 多 的 事情 ”的 哲学 ， 也 是 指导 Go 语言 设计 的 哲学 。 


如 果 希 望 让 goroutine 并 行 ， 必 须 使 用 多 于 一 个 逻辑 处 理 器 。 当 有 多 
个 逻辑 处 理 器 时 ， 调 度 器 会 将 goroutine 平 等 分 配 到 每 个 多 辑 处 理 器 上 。 
这 会 让 goroutine 在 不 同 的 线程 上 运行 。 不 过 要 想 真 的 实现 并 行 的 效果 ， 
用 户 需 要 让 自己 的 程序 运行 在 有 多 个 物理 处 理 器 的 机 器 上 。 否 则 ， 哪 怕 
Go 语言 运行 时 使 用 多 个 线程 ，goroutine 依 然 会 在 同一 个 物理 处 理 器 上 并 
发 运行 ， 达 不 到 并 行 的 效果 。 


图 6-3 展 示 了 在 一 个 逻辑 处 理 嚣 上 并 发 运行 goroutine 和 在 两 个 逻辑 处 
理 器 上 并 行 运行 两 个 并 发 的 goroutine 之 间 的 区 别 。 调 度 器 包含 一 些 聪明 
的 算法 ， 这 些 算法 会 随 着 Go 语言 的 发 布 被 更 新 和 改进 ， 所 以 不 推荐 盲 
目 修改 语言 运行 时 对 人 逻辑 处 理 器 的 默认 设置 。 如 果真 的 认为 修改 逻辑 处 
理 器 的 数量 可 以 改进 性 能 ， 也 可 以 对 语言 运行 时 的 参数 进行 细微 调整 。 
后 面 会 介绍 如 何 做 这 种 修改 。 
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图 6-3 ”并 发 和 并 行 的 区 别 


6.2 goroutine 

让 我 们 再 深入 了 解 一 下 调度 器 的 行为 ， 以 及 调度 器 是 如 何 创建 
goroutine 并 管理 其 寿命 的 。 我 们 会 先 通 过 在 一 个 逻辑 处 理 器 上 运行 的 例 
子 来 讲解 ， 再 来 讨论 如 何 让 goroutine 并 行 运行 。 代 码 清单 6-1 所 示 的 程序 
会 创建 两 个 goroutine， 以 并 发 的 形式 分 别 显示 大 写 和 小 写 的 英文 字母 。 


代码 清单 6-1 listing01.go 











81 // 这 个 示例 程序 展示 如 何 创 建 goroutine 
82 // 以 及 调度 器 的 行为 


63 package main 





04 

865 import ( 

66 "fmt" 

67 "runtime" 
68 "sync" 
69 ) 

16 





11 // main 是 所 有 Go 程序 的 入 口 

12 func main() { 

13 // 分 配 一 个 逻辑 处 理 器 给 调度 器 使 用 
14 runtime.GOMAXPROCS(1) 























16 // wg 用 来 等 待 程 序 完成 











17 // 计数 加 2， 表 示 要 等 待 两 个 goroutine 
18 var wg sync.WaitGroup 

19 wg.Add(2) 

20 

21 fmt.Println("Start Goroutines") 
22 


23 // 声明 一 个 匿名 函数 ， 并 创建 一 个 goroutine 
24 go func() { 





























25 // 在 函数 退出 时 调用 Done 来 通知 main 函 数 工 作 已 经 完成 
26 defer wg.Done() 

27 

28 // 显示 字母 表 3 次 

29 for count := 6; count «< 3; count++ { 

30 for char := 'a'; Char < 'a'+26; char++ { 
31 fmt.Printf("%c ", char) 

32 } 

33 } 

34 }() 

35 


36 // 声明 一 个 匿名 函数 ， 并 创建 一 个 goroutine 
37 go func() { 



































38 // 在 函数 退出 时 调用 Done 来 通知 main 函 数 工 作 已 经 完成 
39 defer wg.Done() 

40 

41 // 显示 字母 表 3 次 

42 for count := 6; count «< 3; count++ { 

43 for char := 'A'; char < 'A'+26; char++ { 
44 fmt.Printf("%c ", char) 

45 } 

46 } 

47 }() 

48 

49 // 等 待 goroutine 结 束 

56 fmt.Println("Waiting To Finish") 

51 wg.Wait() 

52 

53 fmt.Println("\nTerminating Program") 

54 } 





在 代码 清单 6-1 的 第 14 行 ， 调 用 了 runtime 包 的 GOMAXPROCS 函数 。 





这 个 函数 允许 程序 更 改 调度 器 可 以 使 用 的 馆 辑 处 理 喜 的 数量 。 如 果 不 想 
在 代码 里 做 这 个 调用 ， 也 可 以 通过 修改 和 这 个 函数 名 字 一 样 的 环境 变量 
的 值 来 更 改 逻 辑 处 理 占 的 数量 。 给 这 个 函数 传 入 1， 是 通知 调度 器 只 能 


为 该 程序 使 用 一 个 逻辑 处 理 器 。 


在 第 24 行 和 第 37 行 ， 我 们 声明 了 两 个 匿名 函数 ， 用 来 显示 英文 字母 
表 。 第 24 行 的 函数 显示 小 写字 母 表 ， 而 第 37 行 的 函数 显示 大 写字 母 表 。 
这 两 个 函数 分 别 通 过 关键 字 go 创建 goroutine 来 执行 。 根 据 代 码 清 单 6-2 
中 给 出 的 输出 可 以 看 到 ， 每 个 goroutine 执 行 的 代码 在 一 个 逻辑 处 理 器 上 
并 发 运行 的 效果 。 























代码 清单 6-2 listing01.go 的 输出 





Start Goroutines 

Waiting To Finish 
ABCDEFGHIJKLMNOPQORS3TUVWXYZABCDE FGHIL JK 
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N 
YZ 
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Terminating Program 








第 一 个 goroutine 完 成 所 有 显示 需要 花 时 间 太 短 了 ， 以 至 于 在 调度 器 
切换 到 第 二 个 goroutine 之 前 ， 就 完成 了 所 有 任务 。 这 也 是 为 什么 会 看 到 
先 输出 了 所 有 的 大 写字 母 ， 之 后 才 输 出 小 写字 母 。 我 们 创建 的 两 个 
goroutine 一 个 接 一 个 地 并 发 运行 ， 独 立 完 成 显示 字母 表 的 任务 。 


如 代码 清单 6-3 所 示 ， 一 旦 两 个 匿名 函数 创建 goroutine 来 执 
行 ，main 中 的 代码 会 继续 运行 。 这 意味 着 main 函数 会 在 goroutine 完 成 
工作 前 返回 。 如 果真 的 返回 了 ， 程 序 就 会 在 goroutine 有 机 会 运行 前 终 
止 。 因 此 ， 在 第 51 行 ，main 函数 通过 NaitGroup ， 等 待 两 个 goroutine 
CL 


代码 清单 6-3 ”listing01.go: 第 17 行 到 第 19 行 ， 第 23 行 到 第 26 行 ， 第 49 行 到 第 51 行 












































16 // wg 用 来 等 待 程 序 完成 
17 // 计数 加 2， 表 示 要 等 待 两 个 goroutine 
18 var wg sync.WaitGroup 








19 wg.Add(2) 


23 // 声明 一 个 匿名 函数 ， 并 创建 一 个 goroutine 








24 go func() { 


























25 // 在 函数 退出 时 调用 Done 来 通知 main 函 数 工作 已 经 完成 
26 defer wg.Done() 

49 // 等 待 goroutine 结 束 

56 fmt.Println("Waiting To Finish") 

51 wg.Wait() 





WaitGroup 是 一 个 计数 信号 量 ， 可 以 用 来 记录 并 维护 运行 的 
goroutine。 如果 WaitGroup 的 值 大 于 0，Wait 方法 就 会 阻塞 。 在 第 18 
行 ， 创 建 了 一 个 WaitGroup 类 型 的 变量 ， 之 后 在 第 19 行 ， 将 这 





个 WaitGroup 的 值 设 置 为 2， 表 示 有 两 个 正在 运行 的 goroutine。 为 了 减 
小 WaitGroup 的 值 并 最 终 释 放 main 函数 ， 要 在 第 26 和 39 行 ， 使 
用 defer 声明 在 函数 退出 时 调用 Done 方法 。 


关键 字 defer 会 修改 函数 调用 时 机 ， 在 正在 执行 的 函数 返回 时 才 真 
正 调用 defer 声明 的 函数 。 对 这 里 的 示例 程序 来 说 ， 我 们 使 用 关键 
字 defer 保证 ， 每 个 goroutine 一 旦 完成 其 工作 就 调用 Done 方法 。 


基于 调度 器 的 内 部 算法 ， 一 个 正 运行 的 goroutine 在 工作 结束 前 ， 可 
以 被 停止 并 重新 调度 。 调 上 度 嚣 这样 做 的 目的 是 防止 某 个 goroutine 长 时 间 
占用 人 逻辑 处 理 器 。 当 goroutine 占 用 时 间 过 长 时 ， 调 度 器 会 停止 当前 正 运 
行 的 goroutine， 并 给 其 他 可 运行 的 goroutine 运 行 的 机 会 。 


图 6-4 从 逻辑 处 理 器 的 角度 展示 了 这 一 场景 。 在 第 1 步 ， 调 度 器 开始 
运行 goroutine A， 而 goroutine B 在 运行 队列 里 等 待 调度 。 之 后 ， 在 第 2 
步 ， 调 度 器 交换 了 goroutine A 和 goroutine B。 由 于 goroutine A 并 没有 完 
成 工作 ， 因 此 被 放 回 到 运行 队列 。 之 后 ， 在 第 3 步 ，goroutine B 完 成 了 
它 的 工作 并 被 系统 销毁 。 这 也 让 goroutine A 继续 之 前 的 工作 。 
































图 6-4 ”goroutine 在 逻辑 处 理 器 的 线程 上 进行 交换 


可 以 通过 创建 一 个 需要 长 时 间 才 能 完成 其 工作 的 goroutine 来 看 到 这 

















个 行为 ， 如 代码 清单 6-4 所 示 。 


代码 清单 6-4 listing04.go 





// 这 个 示例 程序 展示 goroutine 调 度 器 是 如 何在 单个 线程 上 
// 切 分 时 间 片 的 


package main 











import ( 
"fmt nn 
"runtime" 
nn sync 1 

) 

















// wg 用 来 等 待 程序 完成 
var wg sync.WaitGroup 





// main 是 所 有 Go 程序 的 入 口 

func main() { 
// 分 配 一 个 钦 辑 处 理 器 给 调度 器 使 用 
runtime.GOMAXPROCS(1) 




















// 计数 加 2， 表 示 要 等 待 两 个 goroutine 


20 wg.Add(2) 











21 

22 // 创建 两 个 goroutine 

23 fmt.Println("Create Goroutines") 
24 go printprime("A") 

25 go printprime("B") 

26 

27 // 等 待 goroutine 结 束 

28 fmt.Println("Waiting To Finish") 
29 wg.Wait() 

30 

31 fmt.Println("Terminating Program") 
32 } 

33 


34 // printPrime 显示 586868 以 内 的 素数 值 
35 func printPrime(prefix string) { 
36 // 在 函数 退出 时 调用 Done 来 通知 main 函 数 工作 已 经 完成 














37 defer wg.Done() 

38 

39 next: 

40 for outer := 2; outer < 5666;j outer++ { 
41 for inner := 2; inner < outer; inner++ { 
42 if outer%inner == 0 { 

43 continue next 

44 } 

45 } 

46 fmt.Printf("%s:%d\n", prefix, outer) 
47 } 

48 fmt.Println("Completed", prefix) 

49 } 





代码 清单 6-4 中 的 程序 创建 了 两 个 goroutine， 分 别 打 印 1~5000 内 的 





素数 。 碍 找 并 显示 素数 会 消耗 不 少时 间 ， 这 会 让 调 度 器 有 机 会 在 第 一 个 
goroutine 找 到 所 有 素数 之 前 ， 切 换 该 goroutine 的 时 间 片 。 


在 第 12 行 中 ， 程 序 启 动 的 时 候 ， 声 明了 一 个 WaitGroup 变量 ， 并 在 
第 20 行 将 其 值 设置 为 2。 之 后 在 第 24 行 和 第 25 行 ， 在 关键 字 go 后 面 指定 
printPrime 函数 并 创建 了 两 个 goroutine 来 执行 。 第 一 个 goroutine 使 用 
前 组 A， 第 二 个 goroutine 使 用 前 绥 B。 和 其 他 画 到 调用 一 样 ， 创 建 为 
goroutine 的 函数 调用 时 可 以 传 入 参数 。 不 过 goroutine 终 止 时 无 法 获取 函 
数 的 返回 值 。 碍 看 代码 清单 6-5 中 给 出 的 输出 时 ， 会 看 到 调度 器 在 切换 


第 一 个 goroutine。 











代码 清单 6-5 listing04.go 的 输出 





Create Goroutines 
Waiting To Finish 
B:2 


切换 goroutine 


切换 goroutine 


切换 goroutine 


Completed A 
Terminating Program 





goroutine B 先 显示 素数 。 一 旦 goroutine B 打 印 到 素数 4591， 调 度 右 
就 会 将 正 运行 的 goroutine 切 换 为 goroutine A。 之 后 goroutine A 在 线程 上 
执行 了 一 段 时 间 ， 再 次 切换 为 goroutine B。 这 次 goroutine B 完 成 了 所 有 
的 工作 。 一 旦 goroutine B 返 回 ， 就 会 看 到 线程 再 次 切换 到 goroutine A 并 
人 的 工作 。 每 次 运行 这 个 程序 ， 调 度 器 切换 的 时 间 点 都 会 稍微 有 


代码 清单 6-1 和 代码 清单 6-4 中 的 示例 程序 展示 了 调度 右 如 何在 一 个 
逻辑 处 理 器 上 并 发 运行 多 个 goroutine。 像 之 前 提 到 的 ，Go 标 准 库 的 
runtime 包 里 有 一 个 名 为 GOMAXPROCS 的 函数 ， 通 过 它 可 以 指定 调度 器 
可 用 的 逻辑 处 理 器 的 数量 。 用 这 个 函数 ， 可 以 给 每 个 可 用 的 物理 处 理 右 
在 运行 的 时 候 分 配 一 个 逻辑 处 理 器 。 代 码 清 单 6-6 展 示 了 这 种 改动 ， 让 
goroutine 并 行 运 行 。 





























代码 清单 6-6 ”如 何 修改 逻辑 处 理 器 的 数量 














import "runtime" 











// 给 每 个 可 用 的 核心 分 配 一 个 逻辑 处 理 器 











runtime.GOMAXPROCS(runtime.NumCPU()) 





包 runtime 提供 了 修改 Go 语言 运行 时 配置 参数 的 能 力 。 在 代码 清 
单 6-6 里 ， 我 们 使 用 两 个 runtime 包 的 函数 来 修改 调度 器 使 用 的 逻辑 处 
理 器 的 数量 。 函 数 NumCPU 返回 可 以 使 用 的 物理 处 理 器 的 数量 。 因 此 ， 
调用 GOMAXPROCS 函数 就 为 每 个 可 用 的 物理 处 理 右 创建 一 个 逻辑 处 理 
器 。 需 要 强调 的 是 ， 使 用 多 个 逻辑 处 理 器 并 不 意味 着 性 能 更 好 。 在 修改 
任何 语言 运行 时 配置 参数 的 时 候 ， 都 需要 配合 基准 测试 来 评估 程序 的 运 
行 效 果 。 

如 果 给 调度 器 分 配 多 个 逻辑 处 理 器 ， 我 们 会 看 到 之 前 的 示例 程序 的 
输出 行为 会 有 些 不 同 。 让 我 们 把 逻辑 处 理 器 的 数量 改 为 2， 并 再 次 运行 
第 一 个 打印 英文 字母 表 的 示例 程序 ， 如 代码 清单 6-7 所 示 。 


代码 清单 6-7 listing07.go 






































61 // 这 个 示例 程序 展示 如 何 创建 goroutine 
62 // 以 及 goroutine 调 度 器 的 行为 


63 package main 





04 

865 :import ( 

66 "fmt" 

67 "runtime" 
68 "sync" 
69 ) 

10 





11 // main 是 所 有 Go 程序 的 入 口 
12 func main() { 


13 // 分 配 2 个 逻辑 处 理 器 给 调度 器 使 用 














14 runtime.GOMAXPROCS(2) 

15 

16 // wg 用 来 等 竺 程序 完成 

17 // 计数 加 2， 表 示 要 等 待 两 个 goroutine 
18 var wg sync.WaitGroup 

19 wg.Add(2) 

20 

21 fmt.Println("Start Goroutines") 
22 


23 // 声明 一 个 匿名 函数 ， 并 创建 一 个 goroutine 





24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
46 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 


54 } 


go func() { 
// 在 函数 退出 时 调用 Done 来 通知 main 函 数 工 作 已 经 完成 
defer wg.Done() 


























// 显示 字母 表 3 次 
for count := 6; count «< 3; count++ { 


for char := 'a'; Char < 'a'+26; char++ { 
fmt.Printf("%c ", char) 


// 声明 一 个 匿名 函数 ， 并 创建 一 个 goroutine 

go func() { 
// 在 函数 退出 时 调用 Done 来 通知 main 函 数 工作 已 经 完成 
defer wg.Done() 





























// 显示 字母 表 3 次 
for count := 6; count «< 3; count++ { 
for char := 'A'; char < 'A'+26; char++ { 
fmt.Printf("%c ", char) 








// 等 待 goroutine 结 束 
fmt.Println("Waiting To Finish") 
wg.Wait() 


fmt.Println("\nTerminating Program") 





代码 清单 6-7 中 给 出 的 例子 在 第 14 行 中 通过 调用 GOMAXPROCS 函数 创 
建 了 两 个 逻辑 处 理 器 。 这 会 让 goroutine 并 行 运行 ， 输 出 结果 如 代码 清单 
6-8 所 示 。 





代码 清单 6-8 listing07.go 的 输出 








Create Goroutines 
Waiting To Finish 
A 


no cc.o 


BCaDEbFcadHeIfJgKhLiMJjJjNKO1LIPmQonRoSpT 
UrVvsNwtXxuYvzZzwAXxByCczDaEbFcadHeITfJjgKhL 
MJjJjNKOLIPmQonRoSpTqUrVvsWNWtXxuYvzwAXByCzD 
EbFcGdHeIfJgKhLiMjNkOlPmQENnRoSpTqUryVv 
WtXuYvZwxyrz 


Terminating Program 


如 果 仔 细 但 看 代码 清单 6-8 中 的 输出 ， 会 看 到 goroutine 是 并 行 运 行 
的 。 两 个 goroutine 几 乎 是 同时 开始 运行 的 ， 大 小 写字 母 是 混合 在 一 起 显 
示 的 。 这 是 在 一 台 8 核 的 电脑 上 运行 程序 的 输出 ， 所 以 每 个 goroutine 独 
自 运行 在 自己 的 核 上 。 记 住 ， 只 有 在 有 多 个 逻辑 处 理 器 且 可 以 同时 让 每 
个 goroutine 运 行 在 一 个 可 用 的 物理 处 理 器 上 的 时 候 ，goroutine 才 会 并 行 


\ 一 /一 


运 们 。 


现在 知道 了 如 何 创 建 goroutine， 并 了 解 这 背后 发 生 的 事情 了 。 下 面 
需要 了 解 一 下 写 并 发 程序 时 的 潜在 危险 ， 以 及 需要 注意 的 事情 。 


6.3 ”竞争 状态 


如 果 两 个 或 者 多 个 goroutine 在 没有 互相 同步 的 情况 下 ， 访 问 某 个 共 
诗 的 资源 ， 并 试图 同时 读 和 写 这 个 资源 ， 残 处 于 相互 苋 争 的 状态 ， 这 种 
情况 被 称 作 竞 争 状 态 (race candition) 。 竞 争 状态 的 存在 是 让 并 发 程序 
变 得 复杂 的 地 方 ， 十 分 容易 引起 潜在 问题 。 对 一 个 共 圣 资源 的 读 和 写 操 
作 必 须 是 原子 化 的 ， 换 句 话说 ， 同 一 时 刻 只 能 有 一 个 goroutine 对 共享 资 
0 0 
了 了 。 



































代码 清单 6-9 listing09.go 




















861 // 这 个 示例 程序 展示 如 何在 程序 里 造成 竞争 状态 
862 // 实际 上 不 希望 出 现 这 种 情况 


63 package main 











04 

65 import ( 

06 eh 

607 "runtime" 
68 "sync" 

69 ) 

106 

11 var ( 

12 // counter 是 所 有 goroutine 都 要 增加 其 值 的 变量 
13 counter int 
14 








15 // wg 用 来 等 待 程序 结束 
16 wg sync.WaitGroup 


























19 // main 是 所 有 Go 程序 的 入 口 

26 func main() { 

21 // 计数 加 2， 表 示 要 等 待 两 个 goroutine 
22 wg.Add(2) 

23 

24 // 创建 两 个 goroutine 

25 go incCounter(1) 

26 go incCounter(2) 

27 

28 // 等 待 goroutine 结 束 

29 wg.Wait() 

36 fmt.Println("Final Counter:", counter) 
31 } 

32 
































33 // incCounter 增 加 包 里 counter 变 量 的 值 
34 func incCounter(id int) { 
35 // 在 函数 退出 时 调用 Done 来 通知 main 函 数 工作 已 经 完成 
































36 defer wg.Done() 

37 

38 for count := 6; count < 2; count++ { 
39 // 捕获 counter 的 值 

40 value := counter 

41 

42 // 当前 goroutine 从 线程 退出 ， 并 放 回 到 队列 
43 runtime.Gosched() 

44 

45 // 增加 本 地 value 变 量 的 值 

46 Value++ 

47 

48 // 将 该 值 保存 回 counter 

49 counter = value 

56 } 

51 } 





对 应 的 输出 如 代码 清单 6-10 所 示 。 























代码 清单 6-10 ”listing09.go 的 输出 


Final Counter: 2 


变量 counter 会 进行 4 次 读 和 写 操作 ， 每 个 goroutine 执 行 两 次 。 但 


和 是， 程序 终止 时 ，counter 变量 的 值 为 2。 图 6-5 提 供 了 为 什么 会 这 样 的 
线 有 


NO 


每 个 goroutine 都 会 覆盖 另 一 个 goroutine 的 工作 。 这 种 履 兰 发 生 在 
goroutine 切 换 的 时 候 。 每 个 goroutine 创 造 了 一 个 counter 变量 的 副本 ， 
之 后 束 切 换 到 男 一 个 goroutine。 当 这 个 goroutine 再 次 运行 的 时 
候 ，counter 变量 的 值 已 经 改变 了 了 ， 但 是 goroutine 并 没有 更 新 自己 的 那 
个 副本 的 值 ， 而 是 继续 使 用 这 个 副本 的 值 ， 用 这 个 值 递增 ， 并 存 回 
counter 变量 ， 结 果 和 窟 新 了 男 一 个 goroutine 完 成 的 工作 。 








图 6-5 ”竞争 状态 下 程序 行为 的 图 像 表 达 








让 我 们 顺 着 程序 理解 一 下 发 生 了 什么 。 在 第 25 行 和 第 26 行 ， 使 


用 incCounter 函数 创建 了 两 个 goroutine。 在 第 34 行 ，incCounter 函 
数 对 包 内 变量 counter 进行 了 读 和 写 操作 ， 而 这 个 变量 是 这 个 示例 程序 
里 的 共享 资源 。 每 个 goroutine 都 会 先 读 出 这 个 counter 变量 的 值 ， 并 在 
第 40 行 将 counter 变量 的 副本 存 入 一 个 叫 作 value 的 本 地 变量 。 之 后 在 
第 46 行 ，incCounter 函数 对 value 的 副本 的 值 加 1， 最 终 在 第 49 行 将 
这 个 新 值 存 回 到 counter 变量 。 这 个 函数 在 第 43 行 调用 了 runtime 包 的 
Gosched 函数 ， 用 于 将 goroutine 从 当前 线程 退出 ， 给 其 他 goroutine 运 行 
的 机 会 。 在 两 次 操作 中 间 这 样 做 的 目的 是 强制 调度 器 切换 两 个 
goroutine， 以 便 让 苋 争 状态 的 效果 变 得 更 明显 。 

Go 语言 有 一 个 特别 的 工具 ， 可 以 在 代码 里 检测 竞争 状态 。 在 查找 
这 类 错误 的 时 候 ， 这 个 工具 非常 好 用 ， 无 其 是 在 竞争 状态 并 不 像 这 个 例 
子 里 这 么 明显 的 时 候 。 让 我 们 用 这 个 竞争 检测 器 来 检测 一 下 我 们 的 例子 
代码 ， 如 代码 清单 6-11 所 示 。 


代码 清单 6-11 用 竞争 检测 器 来 编译 并 执行 listing09 的 代码 















































go build -race // 用 竞争 检测 器 标志 来 多 
./example // 运行 程序 











WARNING: DATA RACE 
Write by goroutine 5: 


main.incCounter() 
/example/main.go:49 +0x96 


Previous read by goroutine 6: 
main.incCounter() 
/example/main.go:46 +0x66 


Goroutine 5 (running) created at: 
main.main() 
/example/main.go:25 +Ox5c 


Goroutine 6 (running) created at: 
main.main() 
/example/main.go:26 +0Xx73 


Final Counter: 2 
Found 1 data race(s) 





代码 清单 6-11 中 的 竞争 检测 恬 指 出 这 个 例子 里 面 代码 清单 6-12 所 未 
的 4 行 代 码 有 问题 。 





代码 清单 6-12 ”竞争 检测 器 指出 的 代码 





: counter = Value 
: Value := counter 
: go incCounter(1) 


: go incCounter(2) 








代码 清单 6-12 展 示 了 竞争 检测 需 查 到 的 哪个 goroutine 引 发 了 数据 兖 
争 ， 以 及 哪 两 行 代码 有 冲突 。 坚 不 奇怪 ， 这 几 行 代码 分 别 是 对 counter 
变量 的 读 和 写 操作 。 


一 种 修正 代码 、 消 除 苋 争 状态 的 办 法 是 ， 使 用 Go 语言 提供 的 锁 机 
制 ， 来 锁 住 共享 资源 ， 从 而 保证 goroutine 的 同步 状态 。 











6.4 锁 住 共享 资源 


Go 语言 提供 了 传统 的 同步 goroutine 的 机 制 ， 就 是 对 共享 资源 加 锁 。 
如 采 需 要 顺序 访问 一 个 整 型 变量 或 者 一 段 代 码 ，atomic 和 sync 包 里 的 
函数 提供 了 很 好 的 解决 方案 。 下 面 我们 了 解 一 下 atomic 包 里 的 几 个 函 
数 以 及 sync 包 里 的 mutex 类 型 。 


6.4.1 原子 函数 
原子 函数 能 够 以 很 底层 的 加 锁 机 制 来 同步 访问 整 型 变量 和 指针 。 我 


人 以 用 原子 函数 来 修正 代码 清单 6-9 中 创建 的 竞争 状态 ， 如 代码 清单 6- 
13 所 不 。 











代码 清单 6-13 listing13.go 














81 // 这 个 示例 程序 展示 如 何 使 用 atomic 包 来 提供 
82 // 对 数值 类 型 的 安全 访问 


63 package main 








04 
65 import ( 
66 "fmt" 


07 "runtime" 





































































































加 其 值 的 变量 


到 队列 


68 "sync" 

69 "sync/atomic" 

16 ) 

11 

12 var ( 

13 // counter 是 所 有 goroutine 都 要 增 

14 counter int64 

15 

16 // wg 用 来 等 待 程序 结束 

17 wg sync.WaitGroup 

18 ) 

19 

26 // main 是 所 有 Go 程序 的 入 口 

21 func main() { 

22 // 计数 加 2， 表 示 要 等 待 两 个 goroutine 
23 wg.Add(2) 

24 

25 // 创建 两 个 goroutine 

26 go incCounter(1) 

27 go incCounter(2) 

28 

29 // 等 待 goroutine 结 束 

36 wg.Wait() 

31 

32 // 显示 最 终 的 值 

33 fmt.Println("Final Counter:", counter) 
34 } 

35 

36 // incCounter 增 加 包 里 counter 变 量 的 值 
37 func incCounter(id int) { 

38 // 在 函数 退出 时 调用 Done 来 通知 main 函 数 工 作 已 经 完成 
39 defer wg.Done() 

40 

41 for count := 6; count < 2; count++ { 
42 // 安全 地 对 counter 加 1 

43 atomic.AddInt64(&counter, 1) 
44 

45 // 当前 goroutine 从 线程 退出 ， 并 放 回 
46 runtime.Gosched() 

47 } 

48 } 


对 应 的 输出 如 代码 清单 6-14 所 示 。 














代码 清单 6-14 ”listing13.go 的 输出 











Final Counter: 4 


现在 ， 程 序 的 第 43 行 使 用 了 atmoic 包 的 AddInt64 函数 。 这 个 函数 
会 同步 整 型 值 的 加 法 ， 方 法 是 强制 同一 时 刻 只 能 有 一 个 goroutine 运 行 并 
完成 这 个 加 法 操作 。 当 goroutine 试 图 去 调用 任何 原子 函数 时 ， 这 些 
i 自动 根据 所 引用 的 变量 做 同步 处 理 。 现 在 我 们 得 到 了 正确 
9 值 4。 


另外 两 个 有 用 的 原子 函数 是 LoadInt64 和 StoreInt64 。 这 两 个 函 
数 提 供 了 一 种 安全 地 读 和 写 一 个 整 型 值 的 方式 。 代 码 清单 6-15 中 的 示例 
程序 使 用 LoadInt64 和 StoreInt64 来 创建 一 个 同步 标志 ， 这 个 标志 可 
以 向 程序 里 多 个 goroutine 通 知 某 个 特殊 状态 。 











代码 清单 6-15 listing15.go 





























61 // 这 个 示例 程序 展示 如 何 使 用 atomic 包 里 的 
62 // Store 和 Load 类 函数 来 提供 对 数值 类 型 





863 // 的 安全 访问 
64 package main 









































05 

66 import ( 

07 "fmt" 

68 "sync" 

69 "sync/atomic" 

16 "time" 

11 ) 

12 

13 var ( 

14 // shutdown 是 通知 正在 执行 的 goroutine 停 止 工作 的 标志 
15 shutdown int64 

16 

17 // wg 用 来 等 竺 程序 结 
18 wg sync.WaitGroup 
19 ) 

20 


21 // main 是 所 有 Go 程序 的 入 口 
22 func main() { 











23 // 计数 加 2， 表 示 要 等 待 两 个 goroutine 
24 wg.Add(2) 
25 





26 // 创建 两 个 goroutine 
27 go doWork("A") 
28 go doWork("B") 


36 // 给 定 goroutine 执 行 的 时 间 











31 time.Sleep(1 * time.Second) 

32 

33 // 该 停止 工作 了 ， 安 全 地 设置 shutdown 标 志 
34 fmt.Println("Shutdown Now") 

35 atomic.StoreInt64(&shutdown, 1) 

36 

37 // 等 待 goroutine 结 束 

38 wg.Wait() 

39 } 

40 











41 // doWork 用 来 模拟 执行 工作 的 goroutine， 

42 // 检测 之 前 的 shutdown 标 志 来 决定 是 否 提 前 终止 

43 func doWork(name string) { 

44 // 在 函数 退出 时 调用 Done 来 通知 main 函 数 工 作 已 经 完成 






































45 defer wg.Done() 

46 

47 for { 

48 fmt.Printf("Doing %s Work\n", name) 
49 time.Sleep(250 * time.Millisecond) 

56 

51 // 要 停止 工作 了 吗 ? 

52 if atomic.LoadInt64(&shutdown) == 1 { 
53 fmt.Printf("Shutting %s Down\n", name) 
54 break 

55 } 

56 } 

57 } 





在 这 个 例子 中 ， 启 动 了 两 个 goroutine， 并 完成 一 些 工作 。 在 各 自 循 
环 的 每 次 迭代 之 后 ， 在 第 52 行 中 goroutine 会 使 用 LoadInt64 来 检查 
shutdown 变量 的 值 。 这 个 函数 会 安全 地 返回 shutdown 变量 的 一 个 副 
本 。 如 果 这 个 副本 的 值 为 1，goroutine 就 会 跳出 循环 并 终止 。 


在 第 35 行 中 ，main 函数 使 用 StoreInt64 函数 来 安全 地 修 
改 shutdown 变量 的 值 。 如 果 哪 个 doWork goroutine 试 图 在 main 函数 调 
用 StoreInt64 的 同时 调用 LoadInt64 函数 ， 那 么 原子 函数 会 将 这 些 调 
用 互相 同步 ， 保 证 这 些 操作 都 是 安全 的 ， 不 会 进入 竞争 状态 。 


6.4.2 ” 互 斥 锁 
另 一 种 同步 访问 共享 资源 的 方式 是 使 用 互 斥 锁 (mutex ) 。 互 斥 锁 


这 个 名 字 来 自 互 斥 Cmutual exclusion ) 的 概念 。 互 斥 锁 用 于 在 代码 上 创 
圭一 个 临界 区 ， 保 证 同一 时 间 只 有 一 个 goroutine 可 以 执行 这 个 临界 区 代 
码 。 我 们 还 可 以 用 互 斥 锁 来 修正 代码 清单 6-9 中 创建 的 竞争 状态 ， 如 代 


码 清单 6-16 所 示 。 





代码 清单 6-16 


listing16.go 
























































加 其 值 的 变量 
















































































61 // 这 个 示例 程序 展示 如 何 使 用 互 斥 锁 来 
62 // 定义 一 段 需要 同步 访问 的 代码 临界 区 
63 // 资源 的 同步 访问 

64 package main 

05 

866 import ( 

07 "fmt" 

68 "runtime" 

69 "sync" 

16 ) 

11 

12 var ( 

13 // counter 是 所 有 goroutine 都 要 夫 
14 counter int 

15 

16 // wg 用 来 等 待 程序 结束 

17 wg sync.WaitGroup 

18 

19 // mutex 用 来 定义 一 段 代码 临界 区 
20 mutex sync.Mutex 

21 ) 

22 

23 // main 是 所 有 Go 程序 的 入 口 

24 func main() { 

25 // 计数 加 2， 表 示 要 等 待 两 个 goroutine 
26 wg.Add(2) 

27 

28 // 创建 两 个 goroutine 

29 go incCounter(1) 

36 go incCounter(2) 

31 

32 // 等 待 goroutine 结 束 

33 wg.Wait() 

34 fmt.Printf("Final Counter: %d\\n", counter) 
35 } 

36 

37 // incCounter 使 用 互 斥 锁 来 同步 并 保证 安全 访问 ， 
38 // 增加 包 里 counter 变 量 的 值 

39 func incCounter(id int) { 








46 // 在 函数 退出 时 调用 Done 来 通知 main 函 数 工作 已 经 完成 

























































































41 defer wg.Done() 

42 

43 for count := 6; count «< 2; count++ { 
44 // 同一 时 刻 只 允许 一 个 goroutine 进 入 
45 // 这 个 临界 区 

46 mutex.Lock() 

47 { 

48 // 捕获 counter 的 值 

49 value := counter 

50 

51 // 当前 goroutine 从 线程 退出 ， 并 放 回 到 队列 
52 runtime.Gosched() 

53 

54 // 增加 本 地 value 变 量 的 值 

55 Value++ 

56 

27 // 将 该 值 保存 回 counter 

58 counter = value 

59 } 

66 mutex.Unlock() 

61 // 释放 锁 ， 人 允许 其 他 正在 等 待 的 goroutine 
62 // 进入 临界 区 

63 } 

64 } 





对 counter 变量 的 操作 在 第 46 行 和 第 60 行 的 Lock() 和 Unlock() 
函数 调用 定义 的 临界 区 里 被 保护 起 来 。 使 用 大 括号 只 是 为 了 让 临界 区 看 
起 来 更 清晰 ， 并 不 是 必需 的 。 同 一 时 刻 只 有 一 个 goroutine 可 以 进入 临界 
区 。 之 后 ， 直 到 调用 Unlock() 函数 之 后 ， 其 他 goroutine 才 能 进入 临界 
区 。 当 第 52 行 强制 将 当前 goroutine 退 出 当前 线程 后 ， 调 度 器 会 再 次 分 配 
这 个 goroutine 继 续 运 行 。 当 程序 结束 时 ， 我 们 得 到 正确 的 值 4 ， 苋 争 状 


态 不 再 存在 。 
6.5 ”通道 


原子 函数 和 互 斥 锁 都 能 工作 ， 但 是 依靠 它们 都 不 会 让 编写 并 发 程序 
变 得 更 简单 ， 更 不 容易 出 错 ， 或 者 更 有 趣 。 在 Go 语言 里 ， 你 不 仅 可 以 
使 用 原子 函数 和 互 斥 锁 来 保证 对 共享 资源 的 安全 访问 以 及 消除 竞争 状 
人 通过 发 送 和 接收 需要 共 译 的 资源 ， 在 goroutine 之 
间 做 同步 。 





当 一 个 资源 需要 在 goroutine 之 间 共 享 时 ， 通 道 在 goroutine 之 间架 起 
了 一 个 管道 ， 并 提供 了 确保 同步 交换 数据 的 机 制 。 声 明 通道 时 ， 需 要 指 
定 将 要 被 共享 的 数据 的 类 型 。 可 以 通过 通道 共享 内 置 类 型 、 命 名 类 型 、 
结构 类 型 和 引用 类 型 的 值 或 者 指针 。 


在 Go 语言 中 需要 使 用 内 置 函数 make 来 创建 一 个 通道 ， 如 代码 清单 
6-17 所 示 。 


























代码 清单 6-17 使 用 make 创建 通道 


























// 无 缓冲 的 整 型 通道 


unbuffered := make(chan int) 














// 有 缓冲 的 字符 串通 道 
buffered := make(chan string，16) 





在 代码 清单 6-17 中 ， 可 以 看 到 使 用 内 置 函 数 make 创建 了 两 个 通 
道 ， 一 个 无 缓冲 的 通道 ， 一 个 有 绥 冲 的 通道 。make 的 第 一 个 参数 需要 
是 关键 字 chan ， 之 后 跟着 允许 通道 交换 的 数据 的 类 型 。 如 果 创 建 的 是 
之 后 还 需要 在 第 二 个 参数 指定 这 个 通道 的 缓冲 区 的 
小 。 


向 通道 发 送 值 或 者 指针 需要 用 到 <- 操作 符 ， 如 代码 清单 6-18 所 示 。 
代码 清单 6-18 向 通道 发 送 值 



































// 有 缓冲 的 字符 串通 道 
buffered := make(chan string，16) 








// 通过 通道 发 送 一 个 字符 串 
buffered <- "Gopher" 














在 代码 清单 6-18 里 ， 我 们 创建 了 一 个 有 绥 冲 的 通道 ， 数 据 类 型 是 字 
符 串 ， 包 含 一 个 10 个 值 的 缓冲 区 。 之 后 我 们 通过 通道 发 送 字 符 
串 "Gopher" 。 为 了 计 另 一 个 goroutine 可 以 从 该 通道 里 接收 到 这 个 字符 
串 ， 我 们 依旧 使 用 <- 操作 符 ， 但 这 次 是 一 元 运算 符 ， 如 代码 清单 6-19 所 
示 。 








代码 清单 6-19 ”从 通道 里 接收 值 

















// 从 通道 接收 一 个 字符 串 











value := <-buffered 





当 从 通道 里 接收 一 个 值 或 者 指针 时 ，<- 运算 符 在 要 操作 的 通道 变 
量 的 左 侧 ， 如 代码 清单 6-19 所 示 。 


通道 是 否 禹 有 绥 冲 ， 其 行为 会 有 一 些 不 同 。 理 解 这 个 春 异 对 决定 到 
A 下 面 我 们 分 别 介 绍 一 下 这 两 种 类 








6.5.1 无 绥 冲 的 通道 


和 的 通道 (unbuffered channel) 是 指 在 接收 前 没有 能 力 保 存 任 
何 值 的 通道 。 这 种 类 型 的 通道 要 求 发 送 goroutine 和 接收 goroutine 同 时 准 
备 好 ， 才 能 完成 发 送 和 接收 操作 。 如 果 两 个 goroutine 没 有 局 同时 准备 好 ， 
通道 会 导致 先 执 行 发 送 或 接收 操作 的 goroutine 阻 塞 等 待 。 这 种 对 通道 进 
行 发 送 和 接收 的 交互 行为 本 和 里 束 是 同步 的 。 其 中 任意 一 个 操作 都 无 法 离 
开 另 一 个 操作 单独 存在 。 


在 图 6-6 里 ， 可 以 看 到 一 个 例子 ， 展 示 两 个 goroutine 如 何 利用 无 缓冲 
的 通道 来 共享 一 个 值 。 在 第 1 步 ， 两 个 goroutine 都 到 达 通 道 ， 但 哪个 都 
没有 开始 执行 发 送 或 者 接收 。 在 第 2 步 ， 左 侧 的 goroutine 将 它 的 手 伸 进 
了 通道 ， 这 模拟 了 回 通 道 发 送 数据 的 行为 。 这 时 ， 这 个 goroutine 会 在 通 
道中 被 锁 住 ， 直 到 交换 完成 。 在 第 3 步 ， 右 侧 的 goroutine 将 它 的 手 放 入 
通道 ， 这 模拟 了 从 通道 里 接收 数据 。 这 个 goroutine 一 样 也 会 在 通道 中 被 
锁 住 ， 直 到 交换 完成 。 在 第 4 步 和 第 5 步 ， 进 行 交 换 ， 并 最 终 ， 在 第 6 
步 ， 两 个 goroutine 都 将 它们 的 手 从 通道 里 拿 出 来 ， 这 模拟 了 被 锁 住 的 
goroutine 得 到 释放 。 两 个 goroutine 现 在 都 可 以 去 做 别 的 事情 了 。 
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图 6-6 ”使 用 无 缓冲 的 通道 在 goroutine 之 间 同 步 


为 了 讲 得 更 清楚 ， 让 我 们 来 看 两 个 完整 的 例子 。 这 两 个 例子 都 会 使 
用 无 缓冲 的 通道 在 两 个 goroutine 之 间 同 步 交换 数据 。 


在 网 球 比 赛 中 ， 两 位 选手 会 把 球 在 两 个 人 之 间 来 回 传递 。 选 手 总 是 
处 在 以 下 两 种 状态 之 一 : 要 么 在 等 待 接 球 ， 要 么 将 球 打 同 对 方 。 可 以 使 
用 两 个 goroutine 来 模拟 网 球 比 赛 ， 并 使 用 无 缓冲 的 通道 来 模拟 球 的 来 
回 ， 如 代码 清单 6-20 所 示 。 


代码 清单 6-20 listing20.go 








81 // 这 个 示例 程序 展示 如 何 用 无 缓冲 的 通道 来 模拟 


// 2 个 goroutine 间 的 网 球 比 赛 
package main 





import ( 
"fmt" 
"math/rand" 
"sync" 
"time" 

) 

// wg 用 来 等 竺 程序 结束 

















var wg sync.WaitGroup 


func init() { 
rand.Seed(time.Now().UnixNano()) 


} 
// main 是 所 有 Go 程序 的 入 


func main() { 


Dl 
























































// 创建 一 个 无 缓冲 的 通道 
court := make(chan int) 
// 计数 加 2， 表 示 要 等 待 两 个 goroutine 
wg.Add(2) 
// 启动 两 个 选手 
go player("Nadal", court) 
go player("Djokovic", court) 
// 发 球 
court <- 1 
// 等 待 游戏 结束 
wg.Wait() 
} 
// player 模拟 一 个 选手 在 打 网 球 


func player(name string, court chan int) { 
// 在 函数 退出 时 调用 Done 来 通知 main 函 数 工 作 已 经 完成 
defer wg.Done() 




















for { 
// 等 竺 球 被 击 打 过 来 
ball, ok := <-court 
if lok { 





// 如 果 通 道 被 关闭 ， 我 们 就 万 了 
fmt.Printf("Player %s Won\n", name) 














49 return 





























56 } 

51 

52 // 选 随机 数 ， 然 后 用 这 个 数 来 判断 我 们 是 否 丢 球 
53 n := rand.Intn(160) 

54 if n%13 == 6 { 

55 fmt.Printf("Player %s Missed\n", name) 
56 

57 // 关闭 通道 ， 表 示 我 们 输 了 

58 close(court) 

59 return 

66 } 

61 

62 // 显示 击 球 数 ， 并 将 击 球 数 加 1 

63 fmt.Printf("Player %s Hit %d\n", name, ball) 
64 ball++ 

65 

66 // 将 球 打 向 对 手 

67 court <- ball 

68 } 

69 } 





运行 这 个 程序 会 得 到 代码 清单 6-21 所 示 的 输出 。 


代码 清单 6-21 listing20.go 的 输出 























Player Nadal Hit 1 
Player Djokovic Hit 2 
Player Nadal Hit 3 


Player Djokovic Missed 
Player Nadal Won 





在 main 函数 的 第 22 行 ， 创 建 了 一 个 int 类 型 的 无 缓冲 的 通道 ， 让 
两 个 goroutine 在 击 球 时 能 够 互相 同步 。 之 后 在 第 28 行 和 第 29 行 ， 创 建 了 
参与 比赛 的 两 个 goroutine。 在 这 个 时 候 ， 两 个 goroutine 都 阻塞 住 等 竺 击 
球 。 在 第 32 行 ， 将 球 发 到 通道 里 ， 程 序 开始 执行 这 个 比赛 ， 直 到 某 个 
goroutine 输 摊 比 赛 。 


在 player 水 数 里 ， 在 第 43 行 可 以 找到 一 个 无 限 循 环 的 for 语句 。 
在 这 个 循环 里 ， 是 玩 游戏 的 过 程 。 在 第 45 行 ，goroutine 从 通道 接收 数 
据 ， 用 来 表示 等 符 接 球 。 这 个 接收 动作 会 锁 住 goroutine， 直 到 有 数据 发 


送 到 通道 里 。 通 道 的 接收 动作 返回 时 ， 第 46 行 会 检测 ok 标志 是 否 

为 false 。 如 果 这 个 值 是 false ， 表 示 通 道 已 经 被 关闭 ， 游 戏 结束 。 在 
第 53 行 到 第 60 行 ， 会 产生 一 个 随机 数 ， 用 来 决定 goroutine 是 否 击 中 了 

球 。 如 果 击 中 了 球 ， 在 第 64 行 ball 的 值 会 递增 1， 并 在 第 67 行 ， 将 bal1 
作为 球 重 新 放 入 通道 ， 发 送 给 另 一 位 选手 。 在 这 个 时 刻 ， 两 个 goroutine 
都 会 被 锁 住 ， 直 到 交换 完成 。 最 终 ， 某 个 goroutine 没 有 打 中 球 ， 在 第 58 
行 关 闭 通 道 。 之 后 两 个 goroutine 都 会 返回 ， 通 过 defer 声明 的 Done 会 
被 执行 ， 程 序 终止 。 


妨 一 个 例子 ， 用 不 同 的 模式 ， 使 用 无 绥 冲 的 通道 ， 在 goroutine 之 间 
司 步 数据 ， 来 模拟 接力 比赛 。 在 接力 比赛 里 ，4 个 跑步 者 围 统 赛 道 轮流 
跑 《 如 代码 清单 6-22 所 示 ) 。 第 二 个 、 第 三 个 和 第 四 个 跑步 者 要 接 到 前 
一 位 跑步 者 的 接力 棒 后 才能 起 跑 。 比 赛 中 最 重要 的 部 分 是 要 传递 接力 
棒 ， 要 求 同 步 传递 。 在 同步 接力 棒 的 时 候 ， 参 与 接力 的 两 个 跑步 者 必须 
在 同一 时 刻 准备 好 交接 。 

















代码 清单 6-22 listing22.go 

















81 // 这 个 示例 程序 展示 如 何 用 无 缓冲 的 通道 来 模拟 

















62 // 4 个 goroutine 间 的 接力 比赛 


63 package main 


04 

65 import ( 
66 "fmt" 
67 "sync" 
68 "time" 
69 ) 

10 




















11 // wg 用 来 等 竺 程序 结束 
12 var wg sync.WaitGroup 





14 // main 是 所 有 Go 程序 的 入 口 
15 func main() { 

16 // 创建 一 个 无 缓冲 的 通道 
17 baton := make(chan int) 








19 // 为 最 后 一 位 跑步 者 将 计数 加 1 
20 wg.Add(1) 











21 

22 // 第 一 位 跑步 者 持 有 接力 棒 
23 go Runner(baton) 

24 


25 // 开始 比赛 


26 
27 
28 
29 
36 } 
31 


baton <- 1 














// 等 待 比赛 结束 
wg.Wait() 





32 // Runner 模 拟 接力 比赛 中 的 一 位 跑步 者 


33 func Runner(baton chan int) { 


34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
56 
51 
52 
53 
54 
55 
56 
57 
58 
59 
66 
61 
62 
63 
64 
65 } 


var newRunner int 


// 等 得 接力 棒 


runner := <-baton 


// 开始 绕 着 跑道 跑步 
fmt.Printf("Runner %d Running With Baton\n", runner) 








// 创建 下 一 位 跑步 者 

if runner != 4 1 
newRunner = runner + 1 
fmt.Printf("Runner %d To The Line\n", newRunner) 
go Runner(baton) 


} 


// 围绕 跑道 中 8 
time.Sleep(166 * time.Millisecond) 


// 比赛 结束 了 吗 ? 


if runner == 4 1 


fmt.Printf("Runner %d Finished, Race Over\n", runner) 


wg.Done() 
return 


} 


// 将 接力 棒 交 给 下 一 位 跑步 者 

fmt.Printf("Runner %d Exchange With Runner %d\n", 
runner, 
newRunner) 


baton <- newRunner 


运行 这 个 程序 会 得 到 代码 清单 6-23 所 示 的 输出 。 





代码 清单 6-23 








listing22.go 的 输出 


Running With Baton 

To The Line 

Exchange With Runner 2 
Running With Baton 

To The Line 

Exchange With Runner 3 


Running With Baton 

To The Line 

Exchange With Runner 4 
Runner 4 Running With Baton 
Runner 4 Finished, Race Over 





在 main 函数 的 第 17 行 ， 创 建 了 一 个 无 缓冲 的 int 类 型 的 通道 baton 
， 用 来 同步 传递 接力 棒 。 在 第 20 行 ， 我 们 给 NaitGroup 加 1， 这 样 main 
函数 就 会 等 最 后 一 位 跑步 者 跑步 结束 。 在 第 23 行 创建 了 一 个 goroutine， 
用 来 表示 第 一 位 跑步 者 来 到 跑道 。 之 后 在 第 26 行 ， 将 接力 棒 交 给 这 个 跑 
步 者 ， 比 赛 开 始 。 最 终 ， 在 第 29 行 ，main 函数 阻塞 在 NaitGroup ， 等 
候 最 后 一 位 跑步 者 完成 比赛 。 


在 Runner goroutine 里 ， 可 以 看 到 接力 棒 baton 是 如 何在 跑步 者 之 

间 传 递 的 。 在 第 37 行 ，goroutine 对 baton 通道 执行 接收 操作 ， 表 示 等 候 
接力 棒 。 一 旦 接力 棒 传 了 进来 ， 在 第 46 行 束 会 创建 一 位 新 跑步 者 ， 准 备 
接力 下 一 棒 ， 直 到 goroutine 是 第 四 个 跑步 者 。 在 第 50 行 ， 跑 步 者 围绕 跑 
道 跑 100 ms。 在 第 55 行 ， 如 果 第 四 个 跑步 者 完成 了 比 结 ， 束 调用 Done 

， 将 WaitGroup 减 1， 之 后 goroutine 返 回 。 如 果 这 个 goroutine 不 是 第 四 

个 跑步 者 ， 那 么 在 第 64 行 ， 接 力 棒 会 交 到 下 一 个 已 经 在 等 得 的 跑步 者 手 
上 。 在 这 个 时 候 ，goroutine 会 被 锁 住 ， 直 到 交接 完成 。 


在 这 两 个 例子 里 ， 我 们 使 用 无 缓冲 的 通道 同步 goroutine， 模 拟 了 网 
球 和 接力 赛 。 代 码 的 流程 与 这 两 个 活动 在 真实 世界 中 的 流程 完全 一 样 ， 
这 样 的 代码 很 容易 读 懂 。 现 在 知道 了 无 缓冲 的 通道 是 如 何 工 作 的 ， 接 下 
来 我 们 会 学 习 有 绥 冲 的 通道 的 工作 方法 。 


6.5.2 ”有 绥 冲 的 通道 


有 缓冲 的 通道 (buffered channel) 是 一 种 在 被 接收 前 能 存储 一 个 或 
者 多 个 值 的 通道 。 这 种 类 型 的 通道 并 不 强制 要 求 goroutine 之 间 必 须 同 时 
完成 发 送 和 接收 。 通 道 会 阻塞 发 送 和 接收 动作 的 条 件 也 会 不 同 。 只 有 在 
通道 中 没有 要 接收 的 值 时 ， 接 收 动作 才 会 阻塞 。 只 有 在 通道 没有 可 用 绥 








冲 区 容纳 被 发 送 的 值 时 ， 发 送 动作 才 会 阻 守 。 这 导致 有 缓冲 的 通道 和 无 
绥 冲 的 通道 之 间 的 一 个 很 大 的 不 同 : 无 缓冲 的 通道 保证 进行 友 送 和 接收 
的 goroutine 会 在 同一 时 间 进 行 数据 交 换 ， 有 缓冲 的 通道 没有 这 种 保证 。 


在 图 6-7 中 可 以 看 到 两 个 goroutine 分 别 同 有 缓冲 的 通道 里 增加 一 个 值 
和 从 有 缓冲 的 通道 里 移 除 一 个 值 。 在 第 1 步 ， 右 侧 的 goroutine 正 在 从 通 
道 接收 一 个 值 。 在 第 2 步 ， 右 侧 的 这 个 goroutine 独 立 完成 了 接收 值 的 动 
作 ， 而 左 侧 的 goroutine 正 在 发 送 一 个 新 值 到 通道 里 。 在 第 3 步 ， 左 侧 的 
goroutine 还 在 癌 通 道 友 送 新 值 ， 而 右 侧 的 goroutine 正 在 从 通道 接收 另外 
一 个 值 。 这 个 步骤 里 的 两 个 操作 既 不 是 同步 的 ， 也 不 会 互相 阻 时 。 最 
后 ， 在 第 4 步 ， 所 有 的 发 送 和 接收 都 完成 ， 而 通道 里 还 有 几 个 值 ， 也 有 
一 些 空间 可 以 存 更 多 的 值 。 


i 


goroutine goroutine goroutine goroutine 




















goroutine goroutine goroutine goroutine 








图 6-7 使 用 有 缓冲 的 通道 在 goroutine 之 间 同 步 数 据 


让 我 们 看 一 个 使 用 有 缓冲 的 通道 的 例子 ， 这 个 例子 管理 一 
goroutine 来 接收 并 完成 工作 。 有 绥 冲 的 通道 提供 了 一 种 清晰 而 直观 的 方 
式 来 实现 这 个 功能 ， 如 代码 清单 6-24 所 示 。 





代码 清单 6-24 listing24.go 


81 
062 
63 
04 
85 
66 
87 
68 
69 
106 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
46 
41 
42 
43 
44 
45 
46 
47 








// 这 个 示例 程序 展示 如 何 使 用 
// 有 缓冲 的 通道 和 固定 数目 的 
// goroutine 来 处 理 一 堆 工 作 


package main 



























































import ( 
"fmt" 
"math/rand" 
"sync" 
"time" 
) 
const ( 
numberGoroutines = 4 // 要 使 用 的 goroutine 的 数量 
taskLoad = 16 // 要 处 理 的 工作 的 数量 
) 




















// wg 用 来 等 竺 程序 完成 
var wg sync.WaitGroup 


// init 初 始 化 包 ，Go 语 言 运 行 时 会 在 其 他 代码 执行 之 前 
// 优先 执行 这 个 函数 
func init() { 


// 初始 化 随机 数 种 子 
rand.Seed(time.Now().Unix()) 
} 
// main 是 所 有 Go 程序 的 入 口 








func main() { 
// 创建 一 个 有 绥 冲 的 通道 来 管理 工作 


tasks := make(chan string, taskLoad) 






























































// 启动 goroutine 来 处 理工 作 

wg.Add(numberGoroutines) 

for gr := 1; gr <= numberGoroutines; gr++ { 
go worker(tasks, gr) 


} 


// 增加 一 组 要 完成 的 工作 
for post := 1; post <= taskLoad; post++ { 
tasks <- fmt.Sprintf("Task : %d", post) 





} 


// 当 所 有 工作 都 处 理 完 时 关闭 通道 
// 以 便 所 有 goroutine 退 出 
close(tasks) 












































TT 


48 // 等 待 所 有 工作 完成 
49 wg.Wait() 
50 } 





























52 // worker 作 为 goroutine 启 动 来 处 理 
53 // 从 有 缓冲 的 通道 传 入 的 工作 

54 func worker(tasks chan string, worker int) { 
55 // 通知 函数 已 经 返回 










































































56 defer wg.Done() 

57 

58 for { 

59 // 等 竺 分配 工 作 

60 task, ok := <-tasks 

61 if lok { 

62 // 这 意味 着 通道 已 经 空 了 ， 并 且 已 被 关闭 

63 fmt.Printf("Worker: %d : Shutting Down\n", worker) 
64 return 

65 } 

66 

67 // 显示 我 们 开始 工作 了 

68 fmt.Printf("Worker: %d : Started %s\n", worker, task) 
69 

70 // 随机 等 一 段 时 间 来 模拟 工作 

71 sleep := rand.Int63n(166) 

72 time.Sleep(time.Duration(sleep) * time.Millisecond) 
73 

74 // 显示 我 们 完成 了 工作 

75 fmt.Printf("Worker: %d : Completed %s\n", worker, task) 
76 } 

77 } 





运行 这 个 程序 会 得 到 代码 清单 6-25 所 示 的 输出 。 


代码 清单 6-25 ”listing24.go 的 输出 


& 




















Worker: 1 : Started Task : 1 
Worker: 2 : Started Task : 2 
Worker: 3 : Started Task : 3 
Worker: 4 : Started Task 4 
Worker: 1 : Completed Task 站 沪 
Worker: 1 : Started Task : 5 
Worker: 4 : Completed Task : 4 
Worker: 4 : Started Task : 6 
Worker: 1 : Completed Task : 5 
Worker: 1 : Started Task : 7 


Worker: 2 : Completed Task : 2 
Worker: 2 : Started Task : 8 
Worker: 3 : Completed Task : 3 
Worker: 3 : Started Task : 9 
Worker: 1 : Completed Task : 7 
Worker: 1 : Started Task : 16 
Worker: 4 : Completed Task : 6 
Worker: 4 : Shutting Down 
Worker: 3 : Completed Task : 9 
Worker: 3 : Shutting Down 
Worker: 2 : Completed Task : 8 
Worker: 2 : Shutting Down 
Worker: 1 : Completed Task : 16 
Worker: 1 : Shutting Down 





由 于 程序 和 Go 语言 的 调度 器 带 有 随机 成 分 ， 这 个 程序 每 次 执行 得 
到 的 输出 会 不 一 样 。 不 过 ， 通 过 有 绥 冲 的 通道 ， 使 用 所 有 4 个 goroutine 
来 完成 工作 ， 这 个 流程 不 会 变 。 从 输出 可 以 看 到 每 个 goroutine 是 如 何 接 
收 从 通道 里 分 发 的 工作 。 


在 main 函数 的 第 31 行 ， 创 建 了 一 个 string 类 型 的 有 缓冲 的 通道 ， 
缓冲 的 容量 是 10。 在 第 34 行 ， 给 NaitGroup 赋值 为 4， 代 表 创建 了 4 个 工 
作 goroutine。 之 后 在 第 35 行 到 第 37 行 ， 创 建 了 4 个 goroutine， 并 传 入 用 来 
接收 工作 的 通道 。 在 第 40 行 到 第 42 行 ， 将 10 个 字符 串 发 送 到 通道 ， 模 拟 
发 给 goroutine 的 工作 。 一 旦 最 后 一 个 字符 串 发 送 到 通道 ， 通 道 就 会 在 第 
46 行 关闭 ， 而 main 函数 就 会 在 第 49 行 等 待 所 有 工作 的 完成 。 


第 46 行 中 关闭 通道 的 代码 非常 重要 。 当 通道 关闭 后 ，goroutine 依 旧 
可 以 从 通道 接收 数据 ， 但 是 不 能 再 向 通道 里 发 送 数 据 。 能 够 从 已 经 关闭 
的 通道 接收 数据 这 一 点 非常 重要 ， 因 为 这 人 允许 通道 关闭 后 依旧 能 取出 其 
中 组 种 的 全 部 值 ， 而 不 会 有 数据 丢失 。 从 一 个 已 经 关闭 且 没 有 数据 的 通 
道里 获取 数据 ， 总 会 立刻 返回 ， 并 返回 一 个 通道 类 型 的 零 值 。 如 果 在 获 
取 通 道 时 还 加 入 了 可 选 的 标志 ， 束 能 得 到 通道 的 状态 信息 。 


在 worker 函数 里 ， 可 以 在 第 58 行 看 到 一 个 无 限 的 for 循环 。 在 这 
个 循环 里 ， 会 处 理 所 有 接收 到 的 工作 。 每 个 goroutine 都 会 在 第 60 行 阻 
塞 ， 等 待 从 通道 里 接收 新 的 工作 。 一 旦 接收 到 返回 ， 就 会 检查 ok 标 
志 ， 看 通道 是 否 已 经 清空 而 且 关 闭 。 如 果 ok 的 值 是 false ，goroutine 就 
会 终止 ， 并 调用 第 56 行 通过 defer 声明 的 Done 函数 ， 通 知 main 有 工作 
结束 。 























如 果 ok 标志 是 true ， 表 示 接 收 到 的 值 是 有 效 的 。 第 71 行 和 第 72 行 
模拟 了 处 理 的 工作 。 一 旦 工作 完成 ，goroutine 会 再 次 阻塞 在 第 60 行 从 通 
道 获 取 数 据 的 语句 。 一 旦 通道 被 关闭 ， 这 个 从 通道 获取 数据 的 语句 会 这 
刻 返 回 ，goroutine 也 会 终止 自己 。 


有 绥 冲 的 通道 和 无 缓冲 的 通道 的 例子 很 好 地 展示 了 如 何 编写 使 用 通 


道 的 代码 。 在 下 一 童 ， 我 们 会 介绍 真实 世界 里 的 一 些 可 能 会 在 工程 里 用 
到 的 并 发 模式 。 





6.6 小结 


。 并 发 是 指 goroutine 运 行 的 时 候 是 相互 独立 的 。 

。 使 用 关键 字 go 创建 goroutine 来 运行 函数 。 
goroutine 在 逻辑 处 理 器 上 执行 ， 而 逻辑 处 理 器 具有 独立 的 系统 线程 
和 运行 队列 。 

竞争 状态 是 指 两 个 或 者 多 个 goroutine 试 图 访问 同一 个 资源 。 

原子 函数 和 互 斥 锁 提 供 了 一 种 防止 出 现 范 争 状 态 的 办 法 。 

通道 提供 了 一 种 在 两 个 goroutine 之 间 共 享 数 据 的 简单 方法 。 

无 缓冲 的 通道 保证 同时 交换 数据 ， 而 有 绥 冲 的 通道 不 做 这 种 保证 。 





(DD 直到 目前 最 新 的 1.8 版 本 都 是 同一 逻辑 。 可 预见 的 未 来 版 本 也 会 保持 


这 个 逻辑 。 一 一 译 者 注 


第 7 革 ”并 上 肥 侦 却 
本 章 主要 内 容 


。 控制 程序 的 生命 周期 
。 管理 可 复 用 的 资源 池 
。 创建 可 以 处 理 任 务 的 goroutine 池 


在 第 6 章 中 ， 我 们 学 习 了 什么 是 并 用， 通道 是 如 何 工 作 的 ， 并 学 习 
了 可 以 实际 工作 的 并 发 代码 。 本 章 将 通过 学 习 更 多 代码 来 扩展 这 些 知 
识 。 我 们 会 学 习 3 个 可 以 在 实际 工程 里 使 用 的 包 ， 这 3 个 包 分 别 实 现 了 不 
同 的 并 发 模式 。 每 个 包 从 一 个 实用 的 视角 来 讲解 如 何 使 用 并 发 和 通道 。 
人 
为 。 





7.1 runner 


runner 包 用 于 展示 如 何 使 用 通道 来 监视 程序 的 执行 时 间 ， 如 果 程 
序 运 行 时 间 太 长 ， 也 可 以 用 runner 包 来 终止 程序 。 当 开发 需要 调度 后 
台 处 理 任务 的 程序 的 时 候 ， 这 种 模式 会 很 有 用 。 这 个 程序 可 能 会 作为 
cron 作 业 执 行 ， 或 者 在 基于 定时 任务 的 云 环境 〈 如 iron.io) 里 执行 。 


让 我 们 来 看 一 下 runner 包 里 的 runner.go 代 码 文件 ， 如 代码 清单 7-1 
所 示 。 











代码 清单 7-1 runner /runner.go 








61 // Gabriel Aszalos 协 助 完 成 了 这 个 示例 
62 // runner 包 管理 处 理 任 务 的 运行 和 生命 周期 


























63 package runner 
64 


865 import ( 

66 "errors" 

067 "OS" 

68 "os/signal" 
69 "time" 


16 ) 


11 
12 
13 











// Runner 在 给 定 的 超时 时 间 内 执行 一 组 任务 ， 
// 并 且 在 操作 系统 发 送 中 断 信号 时 结束 这 些 任务 

















14 type Runner struct { 


15 
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// interrupt 通 道 报告 从 操作 系统 
// 发 送 的 信和 号 


interrupt chan os.Signal 





// complete 通 道 报告 处 理 任 务 已 经 完成 
complete chan error 





























// timeout 报 告 处 理 任务 已 经 超时 


timeout <-chan 七 ime.Time 











// tasks 持 有 一 组 以 索引 顺序 依次 执行 的 
// 函数 
tasks [Jfunc(int) 





} 
// ErrTimeout 会 在 任务 执行 超时 时 返回 


var ErrTimeout = errors.New("received timeout") 





// ErrInterrupt 会 在 接收 到 操作 系统 的 事件 时 返回 


var ErrInterrupt = errors.New("received interrupt") 





// New 返 回 一 个 新 的 准备 使 用 的 Runner 


func New(d time.Duration) *Runner { 








return &Runnert{ 
interrupt: make(chan os.Signal, 1), 
complete: make(chan error), 
timeout: time.After(d), 
} 
} 
// Add 将 一 个 任务 附加 到 Runner 上 。 这 个 任务 是 一 个 





// 接收 一 个 int 类 型 的 ID 作为 参数 的 函数 
func (r *Runner) Add(tasks ...func(int)) { 
r.tasks = append(r.tasks, tasks...) 


} 
// Start 执 行 所 有 任务 ， 并 监视 通道 事件 


func (r *Runner) Start() error { 
// 我 们 希望 接收 所 有 中 断 信 和 号 
signal.Notify(r.interrupt, os.Interrupt) 












































// 用 不 同 的 goroutine 执 行 不 同 的 任务 
go func() { 


58 r.complete <- r.run() 


















































59 }() 

60 

61 select { 

62 // 当 任 务 处 理 完成 时 发 出 的 信号 
63 case err := <-r.complete: 
64 return err 

65 

66 // 当 任 务 处 理 程序 运行 超时 时 发 出 的 信和 号 
67 case <-r.timeout: 

68 return ErrTimeout 

69 } 

76 } 

71 


72 // run 执 行 每 一 个 已 注册 的 任务 


73 func (Fr *Runner) run() error { 





74 for id, task := range r.tasks { 
75 // 检测 操作 系统 的 中 断 信 和 号 
76 if _ Fr.gotInterrupt() { 
77 return ErrIinterrupt 
78 } 

79 

80 // 执行 已 注册 的 任务 

81 task(id) 

82 } 

83 

84 return nil 

85 } 

86 


87 // gotInterrupt 验 证 是 否 接收 到 了 中 断 信和 号 
88 func (r *Runner) gotInterrupt() bool { 














89 select { 

96 // 当中 断 事件 被 触发 时 发 出 的 信和 号 
91 case <-r.interrupt: 

92 // 停止 接收 后 续 的 任何 信号 
93 signal.Stop(r.interrupt) 
95 return true 

96 

97 // 继续 正常 运行 

98 default: 

99 return false 

160 } 

161 } 











代码 清单 7-1 中 的 程序 展示 了 依据 调度 运行 的 无 人 值守 的 面向 任务 
的 程序 ， 及 其 所 使 用 的 并 发 模式 。 在 设计 上 ， 可 支持 以 下 终止 点 : 


。 程序 可 以 在 分 配 的 时 间 内 完成 工作 ， 正 负 终 止 ; 
。 程序 没有 及 时 完成 工作 ,“ 目 杀 ?”; 
。 | 中 断 事件 ， 程 序 立 刻 试图 清理 状态 并 停止 工 


让 我 们 走 查 一 遍 代 码 ， 看 看 每 个 终止 点 是 如 何 实现 的 ， 如 代码 清单 
7-2 所 示 。 








代码 清单 7-2 ”runner /runner.go: 第 12 行 到 第 28 行 








12 // Runner 在 给 定 的 超时 时 间 内 执行 一 组 任务 ， 

13 // 并 且 在 操作 系统 发 送 中 断 信 号 时 结束 这 些 任 务 

14 type Runner struct { 
// interrupt 通 道 报告 从 操作 系统 
// 发 送 的 信号 


interrupt chan os.Signal 





























// complete 通 道 报告 处 理 任务 已 经 完成 


complete chan error 





























// timeout 报 告 处 理 任务 已 经 超时 


timeout <-chan time.Time 














// tasks 持 有 一 组 以 索引 顺序 依次 执行 的 
// 函数 
tasks [jfunc(int) 





代码 清单 7-2 从 第 14 行 声明 Runner 结构 开始 。 这 个 类 型 声明 了 3 个 
oe 0 周期， 以 及 用 来 表示 顺序 执行 的 不 同 任 
胃 


第 17 行 的 jnterrupt 通道 收发 os .Signal 接口 类 型 的 值 ， 用 来 从 
主机 操作 系统 接收 中 断 事件 。os .Signal 接口 的 声明 如 代码 清单 7-3 所 
示 。 




















代码 清单 7-3 golang.org/pkg/os/#Signal 




















// Signal 用 来 描述 操作 系统 发 送 的 信号 。 其 底层 实现 通常 会 





























// 依赖 操作 系统 的 具体 实现 : 在 UNTX 系 统 上 是 
// syscall.Signal 
type Signal interface { 





String() string 
Signal()// 用 来 区 分 其 他 Stringer 























} 





代码 清单 7-3 展 示 了 os .Signal 接口 的 声明 。 这 个 接口 抽象 了 不 同 
操作 系统 上 捕获 和 报告 信号 事件 的 具体 实现 。 


Re 8 名 为 complete ， 是 一 个 收发 error 接口 类 型 值 的 
， 如 代码 清单 7-4 所 示 。 








代码 清单 7-4。” ”runner /runner.go: 第 19 行 到 第 20 行 






































19 // complete 通 道 报 告 处 理 任 务 已 经 完成 
20 complete chan error 








这 个 通道 被 命名 为 complete ， 因 为 它 侯 执行 任务 的 goroutine 用 来 
发 送 任务 已 经 完成 的 信号 。 如 果 执 行 任务 时 发 生 了 和 错误， 会 通过 这 个 通 
道 发 回 一 个 error 接口 类 型 的 值 。 如 果 没 有 发 生 错 误 ， 会 通过 这 个 通道 
发 回 一 个 nil 值 作为 error 接口 值 。 


三 个 字段 被 命名 为 timeout ， 接 收 time .Time 值 ， 如 代码 清单 7- 
ee 











代码 清单 7-5 ”runner /runner.go: 第 22 行 到 第 23 行 

















// timeout 报 告 处 理 任务 已 经 超时 











timeout <-chan time.Time 





这 个 通道 用 来 管理 执行 任务 的 时 间 。 如 果 从 这 个 通道 接收 到 一 
个 time.Time 的 值 ， 这 个 程序 就 会 试图 清理 状态 并 停止 工作 。 


最 后 一 个 字段 被 命名 为 tasks ， 是 一 个 函数 值 的 切片 ， 如 代码 清单 
7-6 所 示 。 





代码 清单 7-6 ”runner /runner.go: 第 25 行 到 第 27 行 











25 // tasks 持 有 一 组 以 索引 顺序 依次 执行 的 
26 // 函数 


27 tasks [jfunc(int) 


这 些 冰 数值 代表 一 个 接 一 个 顺序 执行 的 函数 。 会 有 一 个 与 main 豫 
数 分 离 的 goroutine 来 执行 这 些 函 数 。 


现在 已 经 声 明了 Runner 类 型 ， 接 下 来 看 一 下 两 个 error 接口 变 
量 ， 这 两 个 变量 分 别 代表 不 同 的 错误 值 ， 如 代码 清单 7-7 所 示 。 


代码 清单 7-7 runner /runner.go: 第 30 行 到 第 34 行 


























36 // ErrTimeout 会 在 任务 执行 超时 时 返回 


31 var ErrTimeout = errors.New("received timeout") 





32 











33 // ErrInterrupt 会 在 接收 到 操作 系统 的 事件 时 返回 


34 var ErrInterrupt = errors.New("received interrupt") 





第 一 个 error 接口 变量 名 为 ErrTimeout 。 这 个 错误 值 会 在 收 到 超 
时 事件 时 ， 由 Start 方法 返回 。 第 二 个 error 接口 变量 名 
为 ErrInterrupt 。 仿 个 错误 信 会 在 收 到 操作 系统 的 中 疡 事件 时 ， 
由 Start 方法 返回 。 


现在 我 们 来 看 一 下 用 户 如 何 创建 一 个 Runner 类 型 的 值 ， 如 代码 清 
单 7-8 所 示 。 





代码 清单 7-8 runner /runner.go: 第 36 行 到 第 43 行 








36 // New 返 回 一 个 新 的 准备 使 用 的 Runner 
37 func New(d time.Duration) *Runner { 
return &Runnert{ 
interrupt: make(chan os.Signal, 1), 





complete: make(chan error), 
timeout: time.After(d), 





代码 清单 7-8 展示 了 名 为 New 的 工厂 函数 。 这 1 个 函数 接收 一 
个 time.Duration 类 型 的 值 ， 并 返回 Runner 3 类 型 的 指针 。 这 个 函数 会 
创建 一 个 Runner 类 型 的 值 ， 并 初始 化 每 个 通道 字段 。 因 为 task 字段 的 


零 值 是 nil ， 已 经 满足 初始 化 的 要 求 ， 所 以 没有 被 明确 初始 化 。 每 个 通 
道 字段 都 有 独立 的 初始 化 过 程 ， 让 我 们 探究 一 下 每 个 字段 的 初始 化 细 
7 


通道 interrupt 被 初始 化 为 缓冲 区 容量 为 1 的 通道 。 这 可 以 保证 通 
道 至 少 能 接收 一 个 来 自 语言 运行 时 的 os.Signal 值 ， 确 保 语 言 运行 时 发 
送 这 个 事件 的 时 候 不 会 被 阻塞 。 如 果 goroutine 没 有 准备 好 接收 这 个 值 ， 
这 个 值 束 会 被 丢弃 。 例 如 ， 如 果 用 户 反 复 融 Ctrl+C 组 合 键 ， 程 序 只 会 在 
这 个 通道 的 缓冲 区 可 用 的 时 候 接 收 事 件 ， 其 余 的 所 有 事件 都 会 被 丢弃 。 


通道 complete 外 饱 始 化 为 无 绥 丁 的 通道 。 当 执行 任务 的 goroutine 
完成 时 ， 会 向 这 个 通道 发 送 一 个 error 类 型 的 值 或 者 nil 值 。 之 后 就 会 
等 待 main 函数 接收 这 个 值 。 一 旦 main 接收 了 这 个 error 值 ，goroutine 
就 可 以 安全 地 终止 了 。 


最 后 一 个 通道 timeout 是 用 time 包 的 After 区 函数 初始 化 
的 。After 函数 返回 一 个 time.Time 类 型 的 通道 。 语 言 运行 时 会 在 指定 
的 duration 时 间 到 期 之 后 ， 癌 这 个 通道 友 送 一 个 time.Time 的 值 。 


现在 知道 了 如 何 创 建 并 初始 化 一 个 Runner 值 ， 我 们 再 来 看 一 下 
与 Runner 类 型 关联 的 方法 。 第 一 个 方法 Add 用 来 增加 一 个 要 执行 的 任 
务 函 数 ， 如 代码 清单 7-9 所 示 。 














代码 清单 7-9 ”runner /runner.go: 第 45 行 到 第 49 行 











45 // Add 将 一 个 任务 附加 到 Runner 上 。 这 个 任务 是 一 个 
46 // 接收 一 个 int 类 型 的 ID 作为 参数 的 函数 
47 func (r *Runner) Add(tasks ...func(int)) { 





48 r.tasks = append(r.tasks, tasks...) 
49 } 





代码 清单 7-9 展 示 了 Add 方法 ， 这 个 方法 接收 一 个 名 为 tasks 的 可 
变 参 数 。 可 变 参 数 可 以 接受 任意 数量 的 值 作为 传 入 参数 。 这 个 例子 
里 ， 这 些 传 入 的 值 必 须 是 一 个 接收 一 个 整数 且 什么 都 个 返回 的 函数 。 函 
数 执行 时 的 参数 tasks 是 一 个 存储 所 有 这 些 传 入 函数 值 的 切片 。 


现在 让 我 们 来 看 一 下 run 方法 ， 如 代码 清单 7-10 所 示 。 


代码 清单 7-10 ”runner /runner.go: 第 72 行 到 第 85 行 














72 // run 执 行 每 一 个 已 注 册 的 任务 
73 func (r *Runner) run() error { 
for id, task := range r.tasks { 
// 检测 操作 系统 的 中 断 信 和 号 
if r.gotInterrupt() { 
return ErrIinterrupt 








} 


// 执行 已 注册 的 任务 
task(id) 
} 


return nil 





代码 清单 7-10 的 第 73 行 的 run 方法 会 迭代 tasks 切片 ， 并 按 顺 序 执 
行 每 个 冰 数 。 函 数 会 在 第 81 行 被 执行 。 在 执行 之 前 ， 会 在 第 76 行 调 
用 gotInterrupt 方法 来 检查 是 否 有 要 从 操作 系统 接收 的 事件 。 


代码 清单 7-11 中 的 方法 gotInterrupt 展示 了 带 default 分 支 的 
select 语句 的 经 典 用 法 。 











代码 清单 7-11 runner /runner.go: 第 87 行 到 第 101 行 








87 // gotInterrupt 验 证 是 否 接收 到 了 中 断 信号 
88 func (r *Runner) gotInterrupt() bool { 
select { 
// 当中 断 事 件 被 触发 时 发 出 的 信和 号 
case <-r.interrupt: 
// 停止 接收 后 续 的 任何 信号 
signal.Stop(r.interrupt) 
return true 














// 继续 正常 运行 
default: 
return false 





在 第 91 行 ， 代 码 试 图 从 interrupt 通道 去 接收 信号 。 一 般 来 
说 ，select 语句 在 没有 任何 要 接收 的 数据 时 会 阻 窒 ,不 过 有 了 第 98 行 
的 default 分 支 就 不 会 阻塞 了 。default 分 支 会 将 接收 interrupt 通 














道 的 阻塞 调用 转变 为 非 阻塞 的 。 如 果 interrupt 通道 有 中 断 信 号 需要 接 
收 ， 就 会 接收 并 处 理 这 个 中 断 。 如 果 没 有 需要 接收 的 信号 ， 就 会 执 
行 default 分 支 。 

当 收 到 中 断 信 号 后 ， 代 码 会 通过 在 第 93 行 调用 Stop 方法 来 停止 接 
收 之 后 的 所 有 事件 。 之 后 函数 返回 true 。 如 果 没 有 收 到 中 断 信 号 ， 在 
第 99 行 该 方法 会 返回 false 。 本 质 上 ，gotInterrupt 方法 会 让 
goroutine 检 和 碍 中 断 信 号 ， 如 果 没 有 发 出 中 断 信 号 ， 就 继续 处 理工 作 。 


这 个 包 里 的 最 后 一 个 方法 名 为 Start ， 如 代码 清单 7-12 所 示 。 


代码 清单 7-12 ”runner /runner.go: 第 51 行 到 第 70 行 









































51 // Start 执 行 所 有 任务 ， 并 监视 通道 事件 

52 func (r *Runner) Start() error { 
// 我 们 希望 接收 所 有 中 断 信 和 号 
signal.Notify(r.interrupt, os.Interrupt) 














// 用 不 同 的 goroutine 执 行 不 同 的 任务 
go func() { 
r.complete <- r.run() 


}() 


select { 

// 当 任 务 处 理 完 成 时 发 出 的 信和 号 

case err := <-r.complete: 
return err 









































// 当 任 务 处 理 程序 运行 超时 时 发 出 的 信号 
case <-r.timeout: 
return ErrTimeout 

















方法 Start 实现 了 程序 的 主流 程 。 在 代码 清单 7-12 的 第 52 
行 ，Start 设置 了 gotInterrupt 方法 要 从 操作 系统 接收 的 中 断 信和 号。 
在 第 56 行 到 第 59 行 ， 声 明了 一 个 匿名 函数 ， 并 单独 启动 goroutine 来 执 
行 。 这 个 goroutine 会 执行 一 系列 被 赋予 的 任务 。 在 第 58 行 ， 在 goroutine 
的 内 部 调用 了 run 方法 ， 并 将 这 个 方法 返回 的 error 接口 值 发 送 
到 complete 通道 。 一 旦 error 接口 的 值 被 接收 ， 该 goroutine 就 会 通过 
通道 将 这 个 值 返回 给 调用 者 。 





创建 goroutine 后 ，Start 进入 一 个 select 语句 ， 阻 塞 等 待 两 个 事 
件 中 的 任意 一 个 。 如 果 从 complete 通道 接收 到 error 接口 值 ， 那 么 该 
goroutine 要 么 在 规定 的 时 间 内 完成 了 分 配 的 工作 ， 要 么 收 到 了 操作 系统 
的 中 断 信 号 。 无 论 哪 种 情况 ， 收 到 的 error 接口 值 都 会 被 返回 ， 随 后 方 
法 终止 。 如 果 从 timeout 通道 接收 到 time .Time 值 ， 就 表示 goroutine 没 
有 在 规定 的 时 间 内 完成 工作 。 这 种 情况 下 ， 程 序 会 返回 ErrTimeout 变 
量 : 





现在 看 过 了 runner 包 的 代码 ， 并 了 解 了 代码 是 如 何 工 作 的 ， 让 我 
们 看 一 下 main.go 代 码 文件 中 的 测试 程序 ， 如 代码 清单 7-13 所 示 。 


代码 清单 7-13 runner /main/main.go 






































61 // 这 个 示例 程序 演示 如 何 使 用 通道 来 监视 


























62 // 程序 运行 的 时 间 ， 以 在 程序 运行 时 间 过 长 
63 // 时 如 何 终止 程序 


63 package main 





604 

65 :import ( 

66 "log" 

67 "time" 

08 

69 "github.com/goinaction/code/chapter7/patterns/runner" 
16 ) 

11 


12 // timeout 规 定 了 必须 在 多 少 秒 内 处 理 完 成 
13 const timeout = 3 * time.Second 





15 // main 是 程序 的 入 口 
16 func main() { 


























17 log.Println("Starting work.") 

18 

19 // 为 本 次 执行 分 配 超时 时 间 

20 r := runner.New(timeout) 

21 

22 // 加 入 要 执行 的 任务 

23 r.Add(createTask(), createTask(), createTask()) 
24 

25 // 执行 任务 并 处 理 结果 

26 if err := r.Start(); err != nil { 

27 switch err { 

28 case runner.ErrTimeout: 

29 log.Println("Terminating due to timeout.") 


36 os .EXjit(1) 


31 case runner.ErrIinterrupt: 

32 log.Println("Terminating due to interrupt.") 
33 os .Exit(2) 

34 } 

35 } 


37 log.Println("Process ended.") 
38 } 








46 // createTask 返 回 一 个 根据 id 
41 // 休眠 指定 秒 数 的 示例 任务 
42 func createTask() func(int) { 


43 return func(id int) { 

44 log.Printf("Processor - Task #%d.", id) 

45 time.Sleep(time.Duration(id) * time.Second) 
46 

47 } 





代码 清单 7-13 的 第 16 行 是 main 函数 。 在 第 20 行 ， 使 用 timeout 作 
为 超时 时 间 传 给 New 函数 ， 并 返回 了 一 个 指 癌 Runner 类 型 的 指针 。 之 
后 在 第 23 行 ， 使 用 createTask 函数 创建 了 几 个 任务 ， 并 被 加 入 Runner 
里 。 在 第 42 行 声明 了 createTask 函数 。 这 个 函数 创建 的 任务 只 是 休 眼 
了 一 段 时 间 ， 用 来 模拟 正在 进行 工作 。 增 加 完 任 务 后 ， 在 第 26 行 调用 了 
Start 方法 ，main 函数 会 等 待 Start 方法 的 返回 。 


当 Start 返回 时 ， 会 检查 其 返回 的 error 接口 值 ， 并 存 入 err 变 
量 。 如 果 确 实 发 生 了 错误 ， 代 码 会 根据 err 变量 的 值 来 判断 方法 是 由 于 
超时 终止 的 ， 还 是 由 于 收 到 了 中 断 信号 终止 。 如 果 没 有 错误 ， 任 务 就 是 
按时 执行 完成 的 。 如 果 执 行 超时 ， 程 序 就 会 用 错误 码 1 终止 。 如 果 接 收 
到 中 断 信号 ， 程 序 就 会 用 错误 码 2 终 止 。 其 他 情况 下 ， 程 序 会 使 用 错误 
码 0 正常 终 止 。 


7.2 pool 


本 章 会 介绍 pool 包 由 。 这 个 包 用 于 展示 如 何 使 用 有 缓冲 的 通道 实 
现 资源 池 ， 来 管理 可 以 在 任意 数量 的 goroutine 之 间 共 享 及 独立 使 用 的 资 
源 。 这 种 模式 在 需要 共享 一 组 静态 资源 的 情况 (如 共享 数据 库 连接 或 者 
内 存 缓冲 区 〉 下 非常 有 用 。 如 果 goroutine 需 要 从 池 里 得 到 这 些 资源 中 的 
一 个 ， 它 可 以 从 池 里 申请 ， 使 用 完 后 归还 到 资源 池 里 。 


让 我 们 看 一 下 pool 包 里 的 pool.go 代码 文件 ， 如 代码 清单 7-14 所 








代码 清单 7-14 poo1 /pool.go 

















// Fatih Arslan 和 Gabriel Aszalos 协 助 完 成 了 这 个 示例 


























// 包 pool 管 理 用 户 定义 的 一 组 资源 
package pool 

















import ( 
"errors" 
"log" 
"io" 
"sync" 
) 
// pool 管理 一 组 可 以 安全 地 在 多 个 goroutine 间 





























// 共享 的 资源 。 被 管理 的 资源 必须 
// 实现 io .Closer 接 口 
type Pool struct { 











m sync.Mutex 
resources chan io.Closer 
factory func() (io.Closer, error) 
closed bool 
} 
// ErrPoolClosed 表 示 请 求 (Acquire) 了 一 个 


// 已 经 关闭 的 池 


var ErrPoolClosed = errors.New("Pool has been closed.") 


























// New 创 建 一 个 用 来 管理 资源 的 池 。 
// 这 个 池 需 要 一 个 可 以 分 配 新 资源 的 函数 ， 
// 并 规定 池 的 大 小 
func New(fn func() (io.Closer, error), size uint) (*Pool, error) { 
if size <= 0 { 
return nil, errors.New("Size value too small.") 

















} 


return &Pool{ 
factory: fn, 
resources: make(chan io.Closer, size), 
}， nil 
} 


// Acquire 从 池 中 获取 一 个 资源 


func (p *Pool) Acquire() (io.Closer, error) { 
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} 


select { 
// 检查 是 否 有 空间 的 资源 
case r, ok := <-p.resources: 
log.Println("Acquire:", "Shared Resource") 
if lok { 
return nil, ErrPoolClosed 








} 


return r, nil 

















// 因为 没有 空闲 资源 可 用 ， 所 以 提供 一 个 新 资源 
default: 
log.Println("Acquire:", "New Resource") 
return p.factory() 


























// Release 将 一 个 使 用 后 的 资源 放 回 池 里 


func (p *Pool) Release(r io.Closer) { 


} 








// 保证 本 操作 和 Close 操 作 的 安全 
p.m.Lock() 
defer p.m.Unlock() 








// 如 果 池 已 经 被 关闭， 销毁 这 个 资源 
if p.closed { 


r.Close() 
return 

} 

select { 


// 试图 将 这 个 资源 放 入 队列 
case p.resources <- r: 
log.Println("Release:", "In Queue") 





// 如 果 队 列 已 满 ， 则 关闭 这 个 资源 





default: 
log.Println("Release:", "Closing") 
r.Close() 

} 


// Close 会 让 资源 池 停 止 工作 ， 并 关闭 所 有 现 有 的 资源 
func (p *Pool) Close() { 











// 保证 本 操作 与 Release 操 作 的 安全 
p.m.Lock() 
defer p.m.Unlock() 





// 如 果 pool 已 经 被 关闭 ， 什 么 也 不 做 


89 if p.closed { 
































90 return 

91 } 

92 

93 // 将 池 关 闭 

94 p.closed = true 

95 

96 // 在 清空 通道 里 的 资源 之 前 ， 将 通道 关闭 
97 // 如 果 不 这 样 做 ， 会 发 生死 锁 
98 close(p.resources) 

99 

166 // 关闭 资源 

161 for r := range p.resources { 
162 r.Close() 





代码 清单 7-14 中 的 pool 包 的 代码 声明 了 一 个 名 为 Pool 的 结构 ， 该 
结构 允许 调用 者 根据 所 需 数量 创建 不 同 的 资源 池 。 只 要 某 类 资源 实现 了 
io.Closer 接口 ， 就 可 以 用 这 个 资源 池 来 管理 。 让 我 们 看 一 下 Pool 结 
构 的 声明 ， 如 代码 清单 7-15 所 示 。 








代码 清单 7-15 ”pool /pool.go: 第 12 行 到 第 20 行 









































// 实现 io.Closer 接 口 
type Pool struct { 
m sync.Mutex 


resources chan io.Closer 
factory func() (io.Closer, error) 
closed bool 





Pool 结构 声明 了 4 个 字段 ， 每 个 字段 都 用 来 辅助 以 goroutine 安 全 的 
方式 来 管理 资源 池 。 在 第 16 行 ， 结 构 以 一 个 sync .Mutex 类 型 的 字段 开 
台 。 这 个 互 斥 锁 用 来 保证 在 多 个 goroutine 访 问 资源 池 时 ， 池 内 的 值 是 安 
全 的 。 第 二 个 字段 名 为 resources ， 被 声明 为 io.Closer 接口 类 型 的 
通道 。 这 个 通道 是 作为 一 个 有 缓冲 的 通道 创建 的 ， 用 来 保存 共享 的 资 
源 。 由 于 通道 的 类 型 是 一 个 接口 ， 所 以 池 可 以 管理 任意 实现 了 
io.Closer 接口 的 资源 类 型 。 





factory 字段 是 一 个 函数 类 型 。 任 何 一 个 没有 输入 参数 且 返 回 一 
个 io.Closer 和 一 个 error 接口 值 的 函数 ， 都 可 以 赋值 给 这 个 字段 。 这 
个 函数 的 目的 是 ， 当 池 需 要 一 个 新 资源 时 ， 可 以 用 这 个 函数 创建 。 这 个 
i 了 pool 包 的 范围 ， 并 且 需 要 由 包 的 使 用 者 实现 并 
/ETAo 

第 19 行 中 的 最 后 一 个 字段 是 closed 字段 。 这 个 字段 是 一 个 标志 ， 
表示 Pool 是 否 已 经 被 关闭 。 现 在 已 经 了 解 了 Pool 结构 的 声明 ， 让 我 们 
看 一 下 第 24 行 声明 的 error 接口 变量 ， 如 代码 清单 7-16 所 示 。 


代码 清单 7-16 ”pool /pool.go: 第 22 行 到 第 24 行 




















22 // ErrPoolClosed 表 示 请 求 (Acquire) 了 一 个 
23 // 已 经 关闭 的 池 


24 var ErrPoolClosed = errors.New("Pool has been closed.") 





Go 语言 里 会 经 常 创建 error 接口 变量 。 这 可 以 让 调用 者 来 判断 某 
个 包 里 的 函数 或 者 方法 返回 的 具体 的 错误 值 。 当 调用 者 对 一 个 已 经 关闭 
的 池 调 用 Acquire 方法 时 ， 会 返回 代码 清单 7-16 里 的 error 接口 变量 。 
因为 Acquire 方法 可 能 返回 多 个 不 同类 型 的 错误 ， 所 以 Pool 已 经 关闭 
时 会 关闭 时 返回 这 个 错误 变量 可 以 让 调用 者 从 其 他 错误 中 识别 出 这 个 特 
定 的 错误 。 

既然 已 经 声明 了 Pool 类 型 和 error 接口 值 ， 我 们 就 可 以 开始 看 一 
下 pool 包 里 声明 的 函数 和 方法 了 。 让 我 们 从 池 的 工厂 函数 开始 ， 这 个 
函数 名 为 New ， 如 代码 清单 7-17 所 示 。 


代码 清单 7-17 ” pool /pool.go: 第 26 行 到 第 38 行 



































26 // New 创 建 一 个 用 来 管理 资源 的 池 。 

27 // 这 个 池 需 要 一 个 可 以 分 配 新 资源 的 函数 ， 

28 // 并 规定 池 的 大 小 

29 func New(fn func() (io.Closer, error), size uint) (*Pool, error) { 
36 if size <= 0 { 

31 return nil, errors.New("Size value too small.") 

32 } 

33 

34 return &Pool{ 

35 factory: fn, 











36 resources: make(chan io.Closer, size), 


37 }， nil 
38 } 


代码 清单 7-17 中 的 New 函数 接受 两 个 参数 ， 并 返回 两 个 值 。 第 一 个 
参数 fn 声明 为 一 个 函数 类 型 ， 这 个 函数 不 接受 任何 参数 ， 返 回 一 
个 io.Closer 和 一 个 error 接口 值 。 这 个 作为 参数 的 函数 是 一 个 工厂 函 
数 ， 用 来 创建 由 池 管 理 的 资源 的 值 。 第 二 个 参数 size 表示 为 了 保存 资 
源 而 创建 的 有 缓冲 的 通道 的 缓冲 区 大 小 。 


第 30 行 检查 了 size 的 值 ， 保 证 这 个 值 不 小 于 等 于 0。 如 果 这 个 值 小 
于 等 于 0， 就 会 使 用 nil 值 作为 返回 的 pool 指针 值 ， 然 后 为 该 错误 创建 
一 个 error 接口 值 。 因 为 这 是 这 个 函数 唯一 可 能 返回 的 错误 值 ， 所 以 不 
需要 为 这 个 错误 单独 创建 和 使 用 一 个 error 接口 变量 。 如 果 能 够 接受 传 
入 的 size ， 就 会 创建 并 初始 化 一 个 新 的 Pool 值 。 在 第 35 行 ， 函 数 参 
数 fn 被 赋值 给 factory 字段 ， 并 且 在 第 36 行 ， 使 用 size 值 创 建 有 缓冲 
的 通道 。 在 return 语句 里 ， 可 以 构造 并 初始 化 任何 值 。 因 此 ， 第 34 行 
的 return 语句 用 指向 新 创建 的 Pool 类 型 值 的 指针 和 nil 值 作为 error 
接口 值 ， 返 回 给 函数 的 调用 者 。 


在 创建 并 初始 化 Pool 类 型 的 值 之 后 ， 接 下 来 让 我 们 来 看 一 
下 Acquire 方法 ， 如 代码 清单 7-18 所 示 。 这 个 方法 可 以 让 调用 者 从 池 里 





代码 清单 7-18 ”pool /pool.go: 第 40 行 到 第 56 行 














46 // Acquire 从 池 中 获取 一 个 资源 
41 func (p *Pool) Acquire() (io.Closer, error) { 























42 select { 

43 // 检查 是 否 有 空闲 的 资源 

44 case r, ok := <-p.resources: 

45 log.Println("Acquire:", "Shared Resource") 
46 if lok { 

47 return nil, ErrPoolClosed 

48 } 

49 return r, nil 

50 


51 // 因为 没有 空闲 资源 可 用 ， 所 以 提供 一 个 新 资源 

52 default: 

53 log.Println("Acquire:", "New Resource") 
54 return p.factory() 

55 } 





56 } 





代码 清单 7-18 包 含 了 Acquire 方法 的 代码 。 这 个 方法 在 还 有 可 用 资 
源 时 会 从 资源 池 里 返回 一 个 资源 ， 人 否则 会 为 该 调用 创建 并 返回 一 个 新 的 
资源 。 这 个 实现 是 通过 select/case 语句 来 检查 有 缓冲 的 通道 里 是 否 
还 有 资源 来 完成 的 。 如 果 通 道里 还 有 资源 ， 如 第 44 行 到 第 49 行 所 写 ， 就 
取出 这 个 资源 ， 并 返回 给 调用 者 。 如 果 该 通道 里 没有 资源 可 取 ， 就 会 执 
行 default 分 文 。 在 这 个 示例 中 ， 在 第 54 行 执行 用 户 提 供 的 工厂 函数 ， 
并 且 创 建 并 返回 一 个 新 资源 。 








如 果 不 再 需要 已 经 获得 的 资源 ， 必 须 将 这 个 资源 释放 回 资源 池 里 。 
这 是 Release 方法 的 任务 。 不 过 在 理解 Release 方法 的 代码 背后 的 机 制 
之 前 ， 我 们 需要 先 看 一 下 Close 方法 ， 如 代码 清单 7-19 所 示 。 


























代码 清单 7-19 ”pool /pool.go: 第 82 行 到 第 104 行 








82 // Close 会 让 资源 池 停 止 工作 ， 并 关闭 所 有 现 有 的 资源 
83 func (p *Pool) Close() { 

// 保证 本 操作 与 Release 操 作 的 安全 

p.m.Lock() 

defer p.m.Unlock() 











// 如 果 pool 已 经 被 关闭 ， 什 么 也 不 做 
if p.closed { 
return 


} 
// 将 池 关 闭 


p.closed = true 








// 在 清空 通道 里 的 资源 之 前 ， 将 通道 关闭 
// 如 果 不 这 样 做 ， 会 发 生死 锁 


close(p.resources) 





























// 关闭 资源 
for r := range p.resources { 
r.Close() 





一 旦 程序 不 再 使 用 资源 池 ， 需 要 调用 这 个 资源 池 的 Close 方法 。 代 


码 清单 7-19 中 展示 了 Close 方法 的 代码 。 在 第 98 行 到 第 101 行 ， 这 个 方 
法 关闭 并 清空 了 有 绥 冲 的 通道 ， 并 将 缓冲 的 空闲 资源 关闭 。 需 要 注意 的 
是 ， 在 同一 时 刻 只 能 有 一 个 goroutine 执 行 这 段 代 码 。 事 实 上 ， 当 这 上段 代 
人 码 被 执行 时 ， 必 须 保证 其 他 goroutine 中 没有 同时 执行 Release 方法 。 你 
一 会 儿 就 会 理解 为 什么 这 很 重要 。 


在 第 85 行 到 第 86 行 ， 互 斥 量 被 加 锁 ， 并 在 函数 返回 时 解锁 。 在 第 89 
行 ， 检 查 closed 标志 ， 判 断 池 是 不 是 已 经 关闭 。 如 果 已 经 关闭 ， 该 方 
法 会 直接 返回 ， 并 释放 锁 。 如 果 这 个 方法 第 一 次 被 调用 ， 就 会 将 这 个 标 
志 设 置 为 true ， 并 关闭 且 清 空 resources 通道 。 


现在 我 们 可 以 看 一 下 Release 方法 ， 看 看 这 个 方法 是 如 何 和 Close 
方法 配合 的 ， 如 代码 清单 7-20 所 示 。 











代码 清单 7-20 ”pool /pool.go: 第 58 行 到 第 80 行 























58 // Release 将 一 个 使 用 后 的 资源 放 回 池 里 
59 func (p *Pool) Release(r io.Closer) { 
// 保证 本 操作 和 Close 操 作 的 安全 

p.m.Lock() 
defer p.m.Unlock() 











// 如 果 池 已 经 被 关闭 ， 销 毁 这 个 资源 
if p.closed { 

r.Close() 

return 


} 


select { 

// 试图 将 这 个 资源 放 入 队列 

case p.resources <- r: 
log.Println("Release:", "In Queue") 





// 如 果 队 列 已 满 ， 则 关闭 这 个 资源 
default: 





log.Println("Release:", "Closing") 
r.Close() 





在 代码 清单 7-20 中 可 以 找到 Release 方法 的 实现 。 该 方法 一 开始 在 
第 61 行 和 第 62 行 对 互 斥 量 进行 加 锁 和 解锁。 这 和 Close 方法 中 的 互 斥 量 





是 同一 个 互 斥 量 。 这 样 可 以 阻止 这 两 个 方法 在 不 同 goroutine 里 同时 运 
行 。 使 用 互 斥 量 有 两 个 目的 。 第 一 ， 可 以 保护 第 65 行 中 读 取 closed 标 
志 的 行为 ， 保 证 同一 时 刻 不 会 有 其 他 goroutine 调 用 Close 方法 写 同 一 个 
标志 。 第 二 ， 我 们 不 想 往 一 个 已 经 关闭 的 通道 里 发 送 数据 ， 因 为 那样 会 
引起 月 尝 。 如 果 closed 标志 是 true ， 我 们 就 知道 resources 通道 已 经 
被 关闭 。 


在 第 66 行 ， 如 果 池 已 经 被 关闭 ， 会 直接 调用 资源 值 r 的 Close 方 
法 。 因 为 这 时 已 经 清空 并 关闭 了 池 ， 所 以 无 法 将 资源 重新 放 回 到 该 资源 
池 里 。 对 closed 标志 的 读 写 必须 进行 同步 ， 否 则 可 能 误导 其 他 
Re 让 其 认为 该 资源 池 依 旧 是 打开 的 ， 并 试图 对 通道 进行 无 效 的 
宁 人 FF 。 


现在 看 过 了 池 的 代码 ， 了 解 了 池 是 如 何 工 作 的 ， 让 我 们 看 一 下 
main.go 代 码 文件 里 的 测试 程序 ， 如 代码 清单 7-21 所 示 。 


代码 清单 7-21 pool /main/main.go 
































81 // 这 个 示例 程序 展示 如 何 使 用 poo1 包 














62 // 来 共享 一 组 模拟 的 数据 库 连 接 


63 package main 

















04 

865 import ( 

66 "log" 

07 "io" 

68 "math/rand" 

69 "sync" 

16 "sync/atomic" 

11 "time" 

12 

13 "github.com/goinaction/code/chapter7/patterns/pool" 
14 ) 

15 

16 const ( 

17 maxGoroutines = 25 // 要 使 用 的 goroutine 的 数量 
18 pooledResources = 2 // 池 中 的 资源 的 数量 

19 ) 

20 





21 // dbConnection 模 拟 要 共享 的 资源 
22 type dbConnection struct { 

23 ID int32 

24 } 


26 
27 
28 
29 
30 
31 
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// Close 实 现 了 io.Closer 接 口 ， 以 便 dbConnection 
// 可 以 被 池 管 理 。Close 用 来 完成 任意 资源 的 
// 释放 管理 


func (dbConn *dbConnection) Close() error { 


























log.Println("Close: Connection", dbConn.ID) 
return nil 

} 

// idCounter 用 来 给 每 个 连接 分 配 一 个 独一无二 的 id 














var idCounter int32 





// createConnection 是 一 个 工厂 函数 ， 

// 当 需 要 一 个 新 连接 时 ， 资 源 池 会 调用 这 个 函数 
func createConnection() (io.Closer, error) { 
id := atomic.AddInt32(&idCounter, 1) 

log.Println("Create: New Connection", id) 














return &dbConnection{id}, nil 


} 
// main 是 所 有 Go 程序 的 入 口 


func main() { 
var wg sync.WaitGroup 
wg.Add(maxGoroutines) 









































// 创建 用 来 管理 连接 的 池 





p，err := pool.New(createConnection, pooledResources) 


if err != nil { 
log.Println(err) 
} 


// 使 用 池 里 的 连接 来 完成 查询 


for query := 6;j query < maxGoroutines; query++ { 








// 每 个 goroutine 需 要 自己 复制 一 份 要 
// 查询 值 的 副本 ， 不 然 所 有 的 查询 会 共享 


























// 同一 个 查询 变量 
go func(q int) { 
performQueries(q, p) 
wg.Done() 
}(query) 
} 
// 等 待 goroutine 结 束 
wg.Wait() 
// 关闭 池 


log.Println("Shutdown Program.") 


73 p.Close() 
74 } 





76 // performQueries 用 来 测试 连接 的 资源 池 
77 func performQueries(query int, p *pool.Pool) { 
78 // 从 池 里 请 求 一 个 连接 









































79 conn, err := p.Acquire() 

80 if err != nil { 

81 log.Println(err) 

82 return 

83 } 

84 

85 // 将 该 连接 释放 回 池 里 

86 defer p.Release(conn) 

87 

88 // 用 等 待 来 模拟 查询 响应 

89 time.Sleep(time.Duration(rand.Intn(1666)) * time.Millisecond) 
90 log.Printf("QID[%d] CID[%d]\n", query, conn.(*dbConnection).ID) 
91 } 





代码 清单 7-21 展 示 的 main.go 中 的 代码 使 用 pool 包 来 管理 一 组 模拟 
数据 库 连接 的 连接 池 。 代 码 一 开始 声明 了 两 个 常量 maxGoroutines 和 
pooledResource ， 用 来 设置 goroutine 的 数量 以 及 程序 将 要 使 用 资源 的 
数量 。 资 源 的 声明 以 及 io.Closer 接口 的 实现 如 代码 清单 7-22 所 示 。 


代码 清单 7-22 pool /main/main.go: 第 21 行 到 第 32 行 





























// dbConnection 模 拟 要 共享 的 资源 
type dbConnection struct { 
ID int32 


} 





// Close 实 现 了 io.Closer 接 口 ， 以 便 dbConnection 
// 可 以 被 池 管 理 。Close 用 来 完成 任意 资源 的 




















// 释放 管理 

func (dbConn *dbConnection) Close() error { 
log.Println("Close: Connection", dbConn.ID) 
return nil 








代码 清单 7-22 展 示 了 dbConnection 结构 的 声明 以 及 io.Closer 接 
口 的 实现 。dbConnection 类 型 模拟 了 管理 数据 库 连 接 的 结构 ， 当 前 版 


本 只 包含 一 个 字段 ID ， 用 来 保存 每 个 连接 的 唯一 标识 。Close 方法 只 
是 报告 了 连接 正在 被 关闭， 并 显示 出 要 关闭 连接 的 标识 。 


接 下 来 我 们 来 看 一 下 创建 dbConnection 值 的 工厂 函数 ， 如 代码 清 
单 7-23 所 示 。 




















代码 清单 7-23 pool /main/main.go: 第 34 行 到 第 44 行 











// idCcounter 用 来 给 每 个 连接 分 配 一 个 独一无二 的 id 
var idCounter int32 





// createConnection 是 一 个 工厂 函数 ， 
// 当 需 要 一 个 新 连接 时 ， 资 源 池 会 调用 这 个 函数 
func createConnection() (io.Closer, error) { 











id := atomic.AddInt32(&idCounter, 1) 
log.Println("Create: New Connection", id) 


return &dbConnection{id}, nil 





代码 清单 7-23 展 示 了 createConnection 函数 的 实现 。 这 个 函数 给 
连接 生成 了 一 个 唯一 标识 ， 显 示 连 接 正 在 被 创建 ， 并 返回 指向 带 有 唯一 
标识 的 dbConnection 类 型 值 的 指针 。 唯 一 标识 是 通过 
atomic.AddInt32 函数 生成 的 。 这 个 函数 可 以 安全 地 增加 包 级 变量 
idCounter 的 值 。 现 在 有 了 资源 以 及 工厂 函数 ， 我 们 可 以 配合 使 
用 pool 包 了 。 


接 下 来 让 我 们 看 一 下 main 函数 的 代码 ， 如 代码 清单 7-24 所 示 。 


代码 清单 7-24 ”pool /main/main.go: 第 48 行 到 第 55 行 























var wg sync.WaitGroup 
wg.Add(maxGoroutines) 



































// 创建 用 来 管理 连接 的 池 








p，err := pool.New(createConnection, pooledResources) 
if err != nil { 
log.Println(err) 


} 





在 第 48 行 ，main 函数 一 开始 就 声明 了 一 个 NaitGroup 值 ， 并 
将 NaitGroup 的 值 设置 为 要 创建 的 goroutine 的 数量 。 之 后 使 用 pool 包 
里 的 New 函数 创建 了 一 个 新 的 Pool 类 型 。 工 厂 函 数 和 要 管理 的 资源 的 
数量 会 传 入 New 函数 。 这 个 函数 会 返回 一 个 指 辐 Pool 值 的 指针 ， 并 检 
查 可 能 的 错误 。 现 在 我 们 有 了 一 个 Pool 类 型 的 资源 池 实 例 ， 就 可 以 创 
建 goroutine， 并 使 用 这 个 资源 池 在 goroutine 之 间 共 享 资 源 ， 如 代码 清单 
7-25 所 示 。 





代码 清单 7-25 ”pool /main/main.go: 第 57 行 到 第 66 行 




















// 使 用 池 里 的 连接 来 完成 查询 
for query := 6;j query < maxGoroutines; query++ { 
每 个 goroutine 需 要 自己 复制 一 份 要 
查询 值 的 副本 ,不然 所 有 的 查询 会 共享 
// 同一 个 查询 变量 





























go func(q int) { 
performQueries(q, p) 
wg.Done() 

}(query) 





代码 清单 7-25 中 用 一 个 for 循环 创建 要 使 用 池 的 goroutine。 每 个 
goroutine 调 用 一 次 performQueries 函数 然后 退出 。performQueries 
函数 需要 传 入 一 个 唯一 的 ID 值 用 于 做 日 志 以 及 一 个 指向 Poo1l 的 指针 。 
一 旦 所 有 的 goroutine 都 创建 完成 ，main 函数 就 等 竺 所 有 goroutine 执 行 完 
毕 ， 如 代码 清单 7-26 所 示 。 




















代码 清单 7-26 ”pool /main/main.go: 第 68 行 到 第 73 行 











// 等 待 goroutine 结 束 
wg.Wait() 


// 关闭 池 


log.Println("Shutdown Program.") 
p.Close() 





在 代码 清单 7-26 中 ，main 函数 等 竺 WaitGroup 实例 的 Nait 方法 执 
行 完成 。 一 旦 所 有 goroutine 都 报告 其 执行 完成 ， 束 关闭 Pool1 ， 并 且 终 
止 程序 。 接 下 来 ， 让 我 们 看 一 下 performQueries 函数 。 这 个 函数 使 用 


了 池 的 Acquire 方法 和 Release 方法 ， 如 代码 清单 7-27 所 示 。 








代码 清单 7-27 pool /main/main.go: 第 76 行 到 第 91 行 




















76 // performQueries 用 来 测试 连接 的 资源 池 
77 func performQueries(query int, p *pool.Pool) { 
// 从 池 里 请 求 一 个 连接 
conn, err := p.Acquire() 
if err != nil { 
log.Println(err) 
return 

















} 























// 将 该 连接 释放 回 池 里 


defer p.Release(conn) 








// 用 等 待 来 模拟 查询 响应 
time.Sleep(time.Duration(rand.Intn(1666)) * time.Millisecond) 
log.Printf("QID[%d] CID[%d]\n", query, conn.(*dbConnection).ID) 





代码 清单 7-27 展 示 了 performQueries 的 实现 。 这 个 实现 使 用 了 
pool 的 Acquire 方法 和 Release 方法 。 这 个 函数 首先 调用 了 Acquire 
方法 ， 从 池 里 获得 dbConnection 。 之 后 会 检查 返回 的 error 接口 值 ， 
在 第 86 行 ， 再 使 用 defer 语句 在 函数 退出 时 将 dbConnection 释放 回 池 
里 。 在 第 89 行 和 第 90 行 ， 随 机 休眠 一 段 时 间 ， 以 此 来 模拟 使 
用 dbConnection 工作 时 间 。 


7.3 work 


work 包 的 目的 是 展示 如 何 使 用 无 缓冲 的 通道 来 创建 一 个 goroutine 
池 ， 这 些 goroutine 执 行 并 控制 一 组 工作 ， 让 其 并 发 执行 。 在 这 种 情况 
下 ， 使 用 无 缓冲 的 通道 要 比 随 意 指 定 一 个 缓冲 区 大 小 的 有 缓冲 的 通道 
好 ， 因 为 这 个 情况 下 既 不 需要 一 个 工作 队列 ， 也 不 需要 一 组 goroutine 配 
合 执行 。 无 缓冲 的 通道 保证 两 个 goroutine 之 间 的 数据 交换 。 这 种 使 用 无 
绥 冲 的 通道 的 方法 允许 使 用 者 知道 什么 时 候 goroutine 池 正在 执行 工作 ， 
而 且 如 果 池 里 的 所 有 goroutine 都 忙 ， 无 法 接受 新 的 工作 的 时 候 ， 也 能 及 
时 通过 通道 来 通知 调用 者 。 使 用 无 缓冲 的 通道 不 会 有 工作 在 队列 里 丢失 
或 者 卡 住 ， 所 有 工作 都 会 被 处 理 。 











让 我 们 来 看 一 下 work 包 里 的 work.go 代 码 文件 ， 如 代码 清单 7-28 所 








代码 清单 7-28 work /work.go 





861 // Jason Waldrip 协 助 完 成 了 这 个 示例 
62 // work 包 管理 一 个 goroutine 池 来 完成 工作 
63 package work 








865 import "sync" 





67 // Worker 必 须 满足 接口 类 型 ， 
68 // 才能 使 用 工作 池 

869 type Worker :interface { 
16 Task() 

11 } 





13 // Pool 提 供 一 个 goroutine 池 ， 这 个 池 可 以 完成 
14 // 任何 已 提交 的 Worker 任 务 
15 type Pool struct { 


16 work chan Worker 
17 wg sync.WaitGroup 
18 } 

19 





26 // New 创 建 一 个 新 工作 池 


21 func New(maxGoroutines int) *Pool { 


22 p := Pool{ 

23 tasks: make(chan Worker), 
24 } 

25 

26 p.wg.Add(maxGoroutines) 

27 for i := 60; i «< maxGoroutines; i++ { 
28 go func() { 

29 for w := range p.work { 
36 w.Task() 

31 } 

32 p.wg.Done() 

33 }() 

34 } 

35 

36 return &p 

37 } 

38 














39 // Run 提 交工 作 到 工作 池 
46 func (p *Pool) Run(w Worker) { 
41 p.work <- w 


42 } 





44 // Shutdown 等 待 所 有 goroutine 停 止 工作 
45 func (p *Pool) Shutdown() { 





46 close(p.work) 
47 p.wg.Wait() 
48 





代码 清单 7-28 中 展示 的 work 包 一 开始 声明 了 名 为 Worker 的 接口 和 
名 为 Pool 的 结构 ， 如 代码 清单 7-29 所 示 。 


代码 清单 7-29 ”work /work.go: 第 07 行 到 第 18 行 


























// Worker 必 须 满 足 接口 > 

// 才能 使 用 工作 池 

type Worker interface { 
Task() 





} 


// Pool 提 供 一 个 goroutine 池 ， 这 个 池 可 以 完成 
// 任何 已 提交 的 Worker 任 务 
type Pool struct { 
work chan Worker 
wg sync.WaitGroup 
} 





代码 清单 7-29 的 第 09 行 中 的 Worker 接口 声明 了 一 个 名 为 Task 的 方 
法 。 在 第 15 行 ， 声 明了 名 为 Pool 的 结构 ， 这 个 结构 类 型 实现 了 
goroutine 池 ， 并 实现 了 一 些 处 理工 作 的 方法 。 这 个 结构 类 型 声明 了 两 个 
字段 ， 一 个 名 为 work (一 个 Worker 接口 类 型 的 通道 ) ， 另 一 个 名 为 wg 
的 sync.WaitGroup 类 型 。 


”“” 接 下 来 ， 让 我 们 来 看 一 下 work 包 的 工厂 函数 ， 如 代码 清单 7-30 所 
修 。 








代码 清单 7-30 ”work /work.go: 第 20 行 到 第 37 行 























28 // New 创 建 一 个 新 工作 池 

21 func New(maxGoroutines int) *Pool { 
22 p := Pool{ 

23 tasks: make(chan Worker), 


24 } 


26 p.wg.Add(maxGoroutines) 

27 for i := 60; i «< maxGoroutines; i++ { 
28 go func() { 

29 for w := range p.work { 

36 w.Task() 


32 p.wg.Done() 
33 }() 
34 } 


36 return &p 





代码 清单 7-30 展 示 了 New 函数 ， 这 个 函数 使 用 固定 数量 的 goroutine 
来 创建 一 个 工作 池 。goroutine 的 数量 作为 参数 传 给 New 函数 。 在 第 22 
创建 了 一 个 Pool 类 型 的 值 ， 并 使 用 无 缓冲 的 通道 来 初始 化 work 字 
Xo 


之 后 ， 在 第 26 行 ， 初 始 化 WaitGroup 需要 等 待 的 数量 ， 并 在 第 27 行 
到 第 34 行 ， 创 建 了 同样 数量 的 goroutine。 这 些 goroutine 只 接收 Worker 
类 型 的 接口 值 ， 并 调用 这 个 值 的 Task 方法 ， 如 代码 清单 7-31 所 示 。 


代码 清单 7-31 work /work.go: 第 28 行 到 第 33 行 











go func() { 
for w := range p.work { 
w.Task() 


p.wg.Done() 








代码 清单 7-31 里 的 for range 循环 会 一 直 阻 寨 ， 直 到 从 work 通道 
收 到 一 个 Worker 接口 值 。 如 果 收 到 一 个 值 ， 就 会 执行 这 个 值 的 Task 方 
法 。 一 旦 work 通道 被 关闭 ，for range 循环 就 会 结束 ， 并 调 
用 WaitGroup 的 Done 方法 。 然 后 goroutine 终 止 。 


现在 我 们 可 以 创建 一 个 等 待 并 执行 工作 的 goroutine 池 了 。 让 我 们 看 
一 下 如 何 癌 池 里 提交 工作 ， 如 代码 清单 7-32 所 示 。 














代码 清单 7-32 ”work /work.go: 第 39 行 到 第 42 行 























39 // Run 提 交工 作 到 工作 池 
46 func (p *Pool) Run(w Worker) { 


41 p.work <- w 
42 } 





代码 清单 7-32 展 示 了 Run 方法 。 这 个 方法 可 以 疝 池 里 提交 工作 。 该 
方法 接受 一 个 Norker 类 型 的 接口 值 作为 参数 ， 并 将 这 个 值 通过 work 通 
道 友 送 。 由 于 work 通道 是 一 个 无 缓冲 的 通道 ， 调 用 者 必须 等 待 工作 池 
里 的 茶 个 goroutine 接 收 到 这 个 值 才 会 返回 。 这 正 是 我 们 想 要 的 ， 这 样 可 
以 保证 调用 的 Run 返回 时 ， 提 交 的 工作 已 经 开始 执行 。 


在 某 个 时 间 点 ， 需 要 关闭 工作 池 。 这 是 Shutdown 方法 所 做 的 事 
情 ， 如 代码 清单 7-33 所 示 。 








代码 清单 7-33 ”work /work.go: 第 44 行 到 第 48 行 











44 // Shutdown 等 待 所 有 goroutine 停 止 工作 
45 func (p *Pool) Shutdown() { 
46 close(p.work) 





p.wg.Wait() 





代码 清单 7-33 中 的 Shutdown 方法 做 了 两 件 事 ， 首 先 ， 它 关闭 了 
work 通道 ， 这 会 导致 所 有 池 里 的 goroutine 停 止 工作 ， 并 调 
用 WaitGroup 的 Done 方法 ; 然后 ，Shutdown 方法 调用 WaitGroup 的 
Wait 方法 ， 这 会 让 Shutdown 方法 等 待 所 有 goroutine 终 止 。 


我 们 看 了 work 包 的 代码 ， 并 了 解 了 它 是 如 何 工 作 的 ， 接 下 来 让 我 
们 看 一 下 main.go 源 代码 文件 中 的 测试 程序 ， 如 代码 清单 7-34 所 示 。 


代码 清单 7-34 work /main/main.go 

















61 // 这 个 示例 程序 展示 如 何 使 用 work 包 
62 // 创建 一 个 goroutine 池 并 完成 工作 
63 package main 

04 

65 import ( 
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"log" 
"sync" 
"time" 


"github.com/goinaction/code/chapter7/patterns/work" 


) 
// names 提供 了 一 组 用 来 显示 的 名 字 


var names = []string{ 
"steve", 
"bob", 
"mary", 
"therese", 
"jason", 




















} 


// namePrinter 使 用 特定 方式 打印 名 字 
type namePrinter struct { 
name string 








} 


// Task 实 现 Worker 接 口 
func (m *namePrinter) Task() { 





log.Println(m.name) 
time.Sleep(time.Second) 
} 
// main 是 所 有 Go 程序 的 入 口 








func main() { 
// 使 用 两 个 goroutine 来 创建 工作 池 
p := work.New(2) 





var wg sync.WaitGroup 
wg.Add(166 * len(names)) 


for i := 0; i < 166; i++ 
// 连 代 names 切 片 
for , name := range names { 
// 创建 一 个 hamePrinter 并 提供 
// 指定 的 名 字 
np := namepPrintert{ 
name: name, 











} 


go func() { 
// 将 任务 提交 执行 。 当 Run 返 回 时 
// 我 们 就 知道 任务 已 经 处 理 完成 








53 p.Run(&np) 
54 wg.Done() 
55 }() 

56 } 

57 } 


59 wg.Wait() 





61 // 让 工作 池 停 止 工作 ， 等 待 所 有 现 有 的 
62 // 工作 完成 
63 p.Shutdown() 














代码 清单 7-34 展 示 了 使 用 work 包 来 完成 名 字 显 示 工 作 的 测试 程 
序 。 这 段 代 码 一 开始 在 第 14 行 声明 了 名 为 names 的 包 级 的 变量 ， 这 个 变 
量 被 声明 为 一 个 字符 串 切 片 。 这 个 切片 使 用 5 个 名 字 进 行 了 初始 化 。 然 
后 声明 了 名 为 namePrinter 的 类 型 ， 如 代码 清单 7-35 所 示 。 


代码 清单 7-35 work /main/main.go: 第 22 行 到 第 31 行 
































// namePrinter 使 用 特定 方式 打印 名 字 
type namePrinter struct { 
name string 





} 


// Task 实 现 Worker 接 口 

func (m *namePrinter) Task() { 
log.Println(m.name) 
time.Sleep(time.Second) 





在 代码 清单 7-35 的 第 23 行 ， 声 明了 namePrinter 类 型 ， 接 着 是 这 个 
类 型 对 Worker 接口 的 实现 。 这 个 类 型 的 工作 任务 是 在 显示 器 上 显示 名 
字 。 这 个 类 型 只 包含 一 个 字段 ， 即 name ， 它 包含 要 显示 的 名 
字 。Worker 接口 的 实现 Task 函数 用 log.Println 函数 来 显示 名 字 ， 
之 后 等 待 1 秒 再 退出 。 等 待 这 1 秒 只 是 为 了 让 测试 程序 运行 的 速度 慢 一 
些 ， 以 便 看 到 并 发 的 效果 。 


有 了 Worker 接口 的 实现 ， 我 们 就 可 以 看 一 下 main 函数 内 部 的 代码 
了 ， 如 代码 清单 7-36 所 示 。 

















代码 清单 7-36 ”work /main/main.go: 第 33 行 到 第 64 行 











33 // main 是 所 有 Go 程序 的 入 口 
34 func main() { 
// 使 用 两 个 goroutine 来 创建 工作 池 
p := work.New(2) 








var wg sync.WaitGroup 
wg.Add(166 * len(names)) 


for i := 0; i < 166; i++ 
// 连 代 names 切 片 
for , name := range names { 
// 创建 一 个 namePrinter 并 提供 
// 指定 的 名 字 
np := namepPrintert{ 
name: name, 


} 


go func() { 
// 将 任务 提交 执行 。 当 Run 返 回 时 
// 我 们 就 知道 任务 已 经 处 理 完 成 
p.Run(&np) 
wg.Done() 


}() 




















} 


wg.Wait() 





// 让 工作 池 停 止 工作 ， 等 待 所 有 现 有 的 
// 工作 完成 
p.Shutdown() 








在 代码 清单 7-36 第 36 行 ， 调 用 work 包 里 的 New 函数 创建 一 个 工作 
池 。 这 个 调用 传 入 的 参数 是 2， 表 示 这 个 工作 池 只 会 包含 两 个 执行 任务 
的 goroutine。 在 第 38 行 和 第 39 行 ， 声 明了 一 个 WaitGroup ， 并 初始 化 为 
要 执行 任务 的 goroutine 数 。 在 这 个 例子 里 ，names 切片 里 的 每 个 名 字 都 
会 创建 100 个 goroutine 来 提交 任务 。 这 样 就 会 有 一 堆 goroutine 互 相 竞 争 ， 
将 任务 提交 到 池 里 。 


在 第 41 行 到 第 43 行 ， 内 部 和 外 部 的 for 循环 用 来 声明 并 创建 所 有 的 


goroutine。 每 次 内 部 循环 都 会 创建 一 个 namePrinter 类 型 的 值 ， 并 提供 
一 个 用 来 打印 的 名 字 。 之 后 ， 在 第 50 行 ， 声 明了 一 个 匿名 函数 ， 并 创建 
一 个 goroutine 执 行 这 个 函数 。 这 个 goroutine 会 调用 工作 池 的 Run 方法 ， 
将 namePrinter 的 值 提交 到 池 里 。 一 旦 工作 池 里 的 goroutine 接 收 到 这 个 
值 ，Run 方法 就 会 返回 。 这 也 会 导致 goroutine 将 NaitGroup 的 计数 圳 
减 ， 并 终止 goroutine。 


一 旦 所 有 的 goroutine 都 创建 完成 ，main 函数 就 会 调用 NaitGroup 
的 Wait 方法 。 这 个 调用 会 等 待 所 有 创建 的 goroutine 提 区 它 们 的 工作 。 
一 旦 Wait 返回 ， 束 会 调用 工作 池 的 Shutdown 方法 来 关闭 工作 
池 。Shutdown 方法 直到 所 有 的 工作 都 做 完 才 会 返回 。 在 这 个 例子 里 ， 
最 多 只 会 等 待 两 个 工作 的 完成 。 








7.4 ”小结 


可 以 使 用 通道 来 控制 程序 的 生命 周期 。 

带 default 分 文 的 select 语句 可 以 用 来 尝试 回 通 道 发 送 或 者 接收 
数据 ， 而 不 会 阻塞 。 

有 绥 冲 的 通道 可 以 用 来 管理 一 组 可 复 用 的 资源 。 

语言 运行 时 会 处 理 好 通道 的 协作 和 同步 。 

使 用 无 缓冲 的 通道 来 创建 完成 工作 的 goroutine 池 。 

任何 时 间 都 可 以 用 无 缓冲 的 通道 来 让 两 个 goroutine 交 换 数 据 ， 在 通 
道 操 作 完 成 时 一 定 保证 对 方 接收 到 了 数据 。 








Q 本 书 是 以 Go 1.5 版 本 为 基础 写作 而 成 的 。 在 Go 1.6 及 之 后 的 版 本 中 ， 
标准 库 里 自 带 了 资源 池 的 实现 (sync.Pool ) 。 推 荐 使 用 。 一 一 译 者 注 


第 8 章 ”标准 库 
本 章 主 要 内 容 


。 输出 数据 以 及 记录 日 志 

。 对 JSON 进 行 编码 和 解码 

。 处 理 输入 /输出 ， 并 以 流 的 方式 处 理 数 据 
。 让 标准 库 里 多 个 包 协 同 工 作 


什么 是 Go 标准 库 ? 为 什么 这 个 库 这 么 重要 ? Go 标准 库 是 一 组 核心 
包 ， 用 来 扩展 和 增强 语言 的 能 力 。 这 些 包 为 语言 增加 了 大 量 不 同 的 类 
型 。 开 发 人 员 可 以 直接 使 用 这 些 类 型 ， 而 不 用 再 写 自 己 的 包 或 者 去 下 载 
其 他 人 发 布 的 第 三 方 包 。 由 于 这 些 包 和 语言 绑 在 一 起 发 布 ， 它 们 会 得 到 
以 下 特殊 的 保证 : 


每 次 语言 更 新 ， 哪 怕 是 小 更 新 ， 都 会 带 有 标准 库 ; 

这 些 标准 库 会 严格 遵守 癌 后 兼容 的 承诺 ; 

标准 库 是 Go 语言 开发 、 构 建 、 发 布 过 程 的 一 部 分 ; 

标准 库 由 Go 的 构建 者 们 维护 和 评审 ; 

每 次 Go 语言 发 布 新 版 本 时 ， 标 准 库 都 会 被 测试 ， 并 评估 性 能 。 


这 些 保证 让 标准 库 变 得 很 特殊 ， 开 及 人 员 应 该 尽量 利用 这 些 标准 
。 使 用 标准 库 里 的 包 可 以 使 管理 代码 变 得 更 容易 ， 并 且 保 证 代码 的 稳 
。 不 用 担心 程序 无 法 兼容 不 同 的 Go 语言 版 本 ， 也 不 用 管理 第 三 方 依 




















漂 岂 证 


如 果 标 准 库 包含 的 包 不 够 好 用 ， 那 么 这 些 好 处 实际 上 没什么 用 。 
Go 语言 社区 的 开发 者 会 比 其 他 语言 的 开发 者 更 依赖 这 些 标准 库 里 的 包 
的 原因 是 ， 标 准 库 本 身 是 经 过 良好 设计 的 ， 并 且 比 其 他 语言 的 标准 库 提 
供 了 更 多 的 功能 。 社 区 里 的 Go 开发 者 会 依赖 这 些 标准 库 里 的 包 做 更 多 
其他 语 襄 中 开发 兰 无 法 做 的 事情 ， 例如 ， 网 络 、HTTP、 图 像 处 理 、 加 





本 章 中 我 们 会 大 致 了 解 标 准 库 的 一 部 分 包 。 之 后 ， 我 们 会 更 详细 地 
探讨 3 个 非常 有 用 的 包 : log 、json 和 io 。 这 些 包 也 展示 了 Go 语言 提 





供 的 重要 且 有 用 的 机 制 。 


8.1 文档 与 源 代码 


标准 库 里 包含 众多 的 包 ， 不 可 能 在 一 章 内 把 这 些 包 都 讲 一 
前 ， 标 准 库 里 总 共有 超过 100 个 包 ， 这 些 包 被 分 到 38 个 类 别 里 ， 人 
清单 8-1 所 示 。 





代码 清单 8-1 标准 库 里 的 顶级 目录 和 包 


archive bufio bytes compress container crypto database 
debug encoding errors expvar flag fmt go 
hash html image index io log math 


mime net Os path reflect regexp runtime 
sort strconv strings Sync syscall testing text 
time unicode unsafe 





代码 清单 8-1 里 列 出 的 许多 分 类 本 里 就 是 一 个 包 。 如 末 想 了 解 所 有 
包 以 及 更 详细 的 描述 ，Go 语 言 团 队 在 网 站 上 维护 了 一 个 文档 ， 参 见 
http://golang.org/pkg/ 。 


golang 网 站 的 pkg 页 面 提 供 了 每 个 包 的 godoc 文档 。 图 8-1 展 示 了 
golang 网 站 上 io 包 的 文档 。 





type Writer 


type Writer interface { 
Write(p []byte) (n int, err error) 
} 


Writer is the interface that wraps the basic Write method. 


Write writes len(p) bytes from p to the underlying data stream. lt returns the number of bytes written from p (0 < 
if it returns n < len(p). Write must not modify the slice data, even temporarily. 





图 8-1 golang.org/pkg/io/#Wiriter 


如 果 想 以 交互 的 方式 浏览 文档 ，Sourcegraph 索 引 了 所 有 标准 库 的 代 
人 码 ， 以 及 大 部 分 包含 Go 代码 的 公开 库 。 图 8-2 是 Sourcegraph 网 站 的 一 个 
例子 ， 展 示 的 是 io 包 的 文档 。 





Write writes len(p) bytes from p to the underlying data stream. 
Tt returns the number of bytes written from p (9 <= n <= len(p)) 
and any error encountered that caused the write to stop early. 
write must return a non-nil error if it returns n < len(p). 
Write must not modify the slice data, even temporarily. 
Writer 

Implementations must not retain p. 

Writer { 


Write(p [] >) (n int, err error) 





图 8-2 sourcegraph.com/code.google.com/p/go/.GoPackage/io/.def/Writer 


不 管用 什么 方式 安装 Go， 标 准 库 的 源 代 码 都 会 安装 在 
$GOROOT/src/pkg 文 件 夹 中 。 拥 有 标准 库 的 源 代码 对 Go 工具 正常 工作 非 
常 重要 。 类 似 godoc 、gocode 其 至 go build 这 些 工具 ， 都 需要 读 取 标 
准 库 的 源 代码 才能 完成 其 工作 。 如 果 源 代码 没有 安装 在 以 上 文件 夹 中 ， 
或 者 无 法 通过 $GOROOT 变量 访问 ， 在 试图 编译 程序 时 会 产生 错误 。 


作为 Go 发 布 包 的 一 部 分 ， 标 准 库 的 源 代码 是 经 过 预 编译 的 。 这 些 
预 编译 后 的 文件 ， 称 作 归 档 文 件 (archive file〉， 可 以 在 
$GOROOTpkg 文 件 夹 中 找到 已 经 安装 的 各 目标 平台 和 操作 系统 的 归档 
文件 。 在 图 8-3 里 ， 可 以 看 到 扩展 名 是 .a 的 文件 ， 这 些 就 是 归档 文件 。 

















呈 include | DS_Store EN html 
全 Iib -GEETIIETTII hm 
LICENSE DY linux_amd64 > CN image 
DN misc > i obj | image.a 
1 PATENTS tool F MN index 
pkg ' 向 | io 
README io.a 
- robots.txt 前 log 
src ’ 1 log.a 
上 test EN math ' 
] VERSION 1 math.a 


图 8-3 ”pkg 文 件 夹 中 的 归档 文件 的 文件 夹 的 视图 


这 些 文件 是 特殊 的 Go 静态 库 文 件 ， 由 Go 的 构建 工具 创建 ， 并 在 纺 
译 和 链接 最 终 程 序 时 被 使 用 。 归 档 文 件 可 以 让 构建 的 速度 更 快 。 但 是 在 
构建 的 过 程 中 ， 没 办 法 指定 这 些 文件 ， 所 以 没 办 法 与 别人 共享 这 些 文 
件 。Go 工 具 链 知道 什么 时 候 可 以 使 用 已 有 的 .a 文 件 ， 什 么 时 候 需要 从 机 
器 上 的 源 代码 重新 构建 。 


有 了 这 些 背 景 知识 ， 证 我 们 看 一 下 标准 库 里 的 几 个 包 ， 看 看 如 何 用 
这 些 包 来 构建 目 己 的 程序 。 


8.2 ”记录 日 志 


即便 没有 表现 出 来 ， 你 的 程序 依旧 可 能 有 bug。 这 在 软件 开发 里 是 
很 目 然 的 事情 。 日 志 是 一 种 找到 这 些 pug， 更 好 地 了 解 程 序 工作 状态 的 
方法 。 日 志 是 开发 人 员 的 眼睛 和 和 耳 打 ， 可 以 用 来 跟 中 、 调 试 和 分 析 代 
码 。 基 于 此 ， 标 准 库 提供 了 log 包 ， 可 以 对 日 志 做 一 些 最 基本 的 配置 。 
根据 特殊 需要 ， 开 发 人 员 还 可 以 自己 定制 日 志 记 录 器 。 


在 UNIX 里 ， 日 志 有 很 长 的 历史 。 这 些 积 累 下 来 的 经 验 都 体现 在 log 
包 的 设计 里 。 传 统 的 CLI (命令 行 界面 ) 程序 直接 将 输出 写 到 名 
为 stdout 的 设备 上 。 所 有 的 操作 系统 上 都 有 这 种 设备 ， 这 种 设备 的 默 
认 目 的 地 是 标准 文本 输出 。 默 认 设置 下 ， 终 端 会 显示 这 些 写 到 stdout 
设备 上 的 文本 。 这 种 单个 目的 地 的 输出 用 起 来 很 方便 ， 不 过 你 总 会 碰 到 
需要 同时 输出 程序 信息 和 输出 执行 细节 的 情况 。 这 些 执行 细节 被 称 作 日 
志 。 当 想 要 记录 日 志 时 ， 你 希望 能 写 到 不 同 的 目的 地 ， 这 样 就 不 会 将 程 
序 的 输出 和 日 志 混 在 一 起 了 。 


为 了 解决 这 个 问题 ，UNIX 架 构 上 增加 了 一 个 叫 作 stderr 的 设备 。 
这 个 设备 被 创建 为 日 志 的 默认 目的 地 。 这 样 开发 人 员 就 能 将 程序 的 输出 
和 日 志 分 离开 来 。 如 果 想 在 程序 运行 时 同时 看 到 程序 输出 和 日 志 ， 可 以 
将 终端 配置 为 同时 显示 写 到 stdout 和 stderr 的 信息 。 不 过 ， 如 果 用 户 
的 程序 只 记录 日 志 ， 没 有 程序 输出 ， 更 常用 的 方式 是 将 一 般 的 日 志 信 息 
写 到 stdout ， 将 错误 或 者 警告 信息 写 到 stderr 。 















































8.2.1 log 包 


让 我 们 从 log 包 提 供 的 最 基本 的 功能 开始 ， 之 后 再 学 习 如 何 创建 定 
制 的 日 志 记 录 器 。 记 录 日 志 的 目的 是 跟踪 程序 什么 时 候 在 什么 位 置 做 了 
什么 。 这 就 需要 通过 某 些 配置 在 每 个 日 志 项 上 要 写 的 一 些 信息 ， 如 代码 
清单 8-2 所 示 。 























代码 清单 8-2 ”跟踪 日 志 的 样 例 








TRACE : 2669/11/16 23:66:606.666666 /tmpfs/gosandbox-/prog.g0:14: message 


[L 


在 代码 清单 8-2 中 ， 可 以 看 到 一 个 由 log 包产 生 的 日 志 项 。 这 个 日 
志 项 包 仿 前缀、 日 期 时 间 戳 、 该 日 志 上 具体 是 由 哪个 源 文 件 记 录 的 、 源 文 
件 记录 日 志 所 在 行 ， 最 后 是 日 志 消 轧 。 让 我 们 看 一 下 如 何 配置 1og 包 来 
输出 这 样 的 日 志 项 ， 如 代码 清单 8-3 所 示 。 




















代码 清 间 








8-3 listing03.go 

















// 这 个 示例 程序 展示 如 何 使 用 最 基本 的 log 包 


package main 








import ( 
"log" 


) 


func init() { 
log.Setprefix("TRACE: ") 
log.SetFlags(log.Ldate | log.Lmicroseconds | log.Llongfile) 


} 


func main() { 
// Println 写 到 标准 日 志 记 录 顺 
log.Println("message") 








// Fatalln 在 调用 Println() 之 后 会 接着 调用 os.Exit(1) 
log.Fatalln("fatal message") 

















// Panicln 在 调用 Println() 之 后 会 接着 调用 panic() 


log.Panicln("panic message") 




















如 果 执 行 代码 清单 8-3 中 的 程序 ， 输 出 的 结果 会 和 代码 清单 8-2 所 示 
出 类 似 。 让 我 们 分 析 一 下 代码 清单 8-4 中 的 代码 ， 看 看 它 是 如 何 工 











代码 清 





8-4 ”listing03.go: 第 08 行 到 第 11 行 














68 func init() { 
69 log.Setprefix("TRACE: ") 
16 log.SetFlags(log.Ldate | log.Lmicroseconds | log.Llongfile) 


11 } 





在 第 08 行 到 第 11 行 ， 定 义 的 函数 名 为 init() 。 这 个 函数 会 在 运 
行 main() 之 前 作为 程序 初始 化 的 一 部 分 执行 。 通 常 程序 会 在 这 
个 init() 函数 里 配置 日 志 人 参数， 这 样 程 序 一 开始 就 能 使 用 log 包 进 行 
正确 的 输出 。 在 这 段 程 序 的 第 9 行 ， 设 置 了 一 个 字符 串 ， 作 为 每 个 日 志 
项 的 前 级 。 这 个 字符 串 应 该 是 能 让 用 户 从 一 般 的 程序 输出 中 分 辨 出 日 志 
的 字符 串 。 传 统 上 这 个 字符 串 的 字符 会 全 部 大 写 。 


有 几 个 和 1og 包 相 关联 的 标志 ， 这 些 标志 用 来 控制 可 以 写 到 每 个 日 
志 项 的 其 他 信息 。 代 码 清单 8-5 展 示 了 目前 包含 的 所 有 标志 。 


代码 清单 8-5 golang.org/src/log/log.go 


























const ( 
// 将 下 面 的 位 使 用 或 运算 符 连 接 在 一 起 ， 可 以 控制 要 输出 的 信息 。 没 有 
// 办 法 控制 这 些 信息 出 现 的 顺序 〈 下 面 会 给 出 顺序 ) 或 者 打印 的 格式 
// (格式 在 注释 里 描述 ) 。 这 些 项 后 面 会 有 
// 2669/61/23 61:23:23.123123 /a/b/c/d.g0:23: message 






























































// 日 期 : 2669/61/23 
Ldate = 1 << iota 


// 时 间 : 81:23:23 
Ltime 

// 毫秒 级 时 间 : 81:23:23.123123。 该 设置 会 覆盖 Ltime 标 志 
Lmicroseconds 











// 完整 路 径 的 文件 名 和 行 号 : /a/b/c/d.go:23 
Llongfile 


// 最 终 的 文件 名 元 素 和 行 号 : d.go:23 
// 履 闵 Llongfile 
Lshortfile 





// 标准 日 志 记 录 器 的 初始 值 
LstdFlags = Ldate | Ltime 





代码 清单 8-5 是 从 log 包 里 直接 摘抄 的 源 代码 。 这 些 标志 被 声明 为 
和 常量， 这 个 代码 块 中 的 第 一 个 常量 叫 作 Ldate ， 使 用 了 特殊 的 语法 来 声 
明 ， 如 代码 清单 8-6 所 示 。 


代码 清单 8-6 ”声明 Ldate 常量 

















// 日 期 : 286869/81/23 
Ldate = 1 << iota 








关键 字 iota 在 常量 声明 区 里 有 特殊 的 作用 。 这 个 关键 字 让 编译 器 
为 每 个 常量 复制 相同 的 表达 式 ， 直 到 声明 区 结束 ， 或 者 过 到 一 个 新 的 赋 
值 语句 。 关 键 字 iota 的 男 一 个 功能 是 ，iota 的 初始 值 为 0， 之 后 iota 
的 值 在 每 次 处 理 为 向量 后 ， 都 会 目 增 1。 让 我 们 更 仔细 地 看 一 下 这 个 天 
键 字 ， 如 代码 清单 8-7 所 示 。 






































代码 清 





8-7 ”使 用 关键 字 iota 














const ( 
Ldate = 1 << iota // 1 << 6 = 066060660666061 1 
Ltime // 1 << 1 = 6000006010 = 2 
Lmicroseconds // 1 «<< 2 = 600660606160 = 4 


Llongfile // 1 «<< 3 = 666661666 = 8 
Lshortfile // 1 << 4 = 666616666 = 16 





代码 清单 8-7 展 示 了 常量 声明 缘 后 的 处 理 方法 。 操 作 符 << 对 左边 的 
操作 数 执行 按 位 左 移 操 作 。 在 每 个 常量 声明 时 ， 都 将 1 按 位 左 移 iota 个 
位 置 。 最 终 的 效果 使 为 每 个 常量 赋予 一 个 独立 位 置 的 位 ， 这 正好 是 标志 
希望 的 工作 方式 。 

常量 LstdFlags 展示 了 如 何 使 用 这 些 标志 ， 如 代码 清单 8-8 所 示 。 


代码 清单 8-8 ”声明 LstdFlags 常量 














const ( 


LstdFlags = Ldate(1) | Ltime(2) = 66666611 = 3 


) 





在 代码 清单 8-8 中 看 到 ， 因 为 使 用 了 复制 操作 符 ，LstdFlags 打破 
了 iota 常数 链 。 由 于 有 | 运算 符 用 于 执行 或 操作 ， 常 量 LstdFlags 被 





3 对 位 进行 或 操作 等 同 于 将 每 个 位 置 的 位 组 合 在 一 起 ， 作 为 最 
终 的 值 。 如 果 对 位 1 和 2 进行 或 操作 ， 最 终 的 结果 束 是 3。 


让 我 们 看 一 下 我 们 要 如 何 设 置 日 志 标 志 ， 如 代码 清单 8-9 所 示 。 
代码 清 























8-9 listing03.go: 第 08 行 到 第 11 行 











88 func init() { 


log.SetFlags(log.Ldate | log.Lmicroseconds | log.Llongfile) 





这 里 我 们 将 Ldate 、Lmicroseconds 和 Llongfile 你 志 组 合 在 一 
起 ， 将 该 操作 的 值 传 入 SetFlags 函数 。 这 些 标志 值 组合 在 一 起 后 ， 最 
终 的 值 是 13 ， 代 表 第 1、3 和 4 位 为 1 (00001101) 。 由 于 每 个 常量 表示 
早 独 一 个 位 ， 这 些 标志 经 过 或 操作 组 合 后 的 值 ， 可 以 表示 每 个 需要 的 日 
参数 。 百 1og 包 会 按 位 检查 这 个 传 入 的 整数 值 ， 按 照 需 求 设置 日 志 
I I 记 采 百 /Ch o 


初始 完 log 包 后 ， 可 以 看 一 下 main() 函数 ， 看 它 是 是 如 何 写 消息 
的 ， 如 代码 清单 8-10 所 示 。 























代码 清单 8-10 listing03.go: 第 13 行 到 第 22 行 











13 func main() { 
// Println 写 到 标准 日 志 记 录 器 
log.Println("message") 





// Fatalln 在 调用 Println() 之 后 会 接着 调用 os.Exit(1) 
log.Fatalln("fatal message") 

















// Panicln 在 调用 Println() 之 后 会 接着 调用 panic() 


log.Panicln("panic message") 











代码 清单 8-10 展 示 了 如 何 使 用 3 个 函数 Println 、Fatalln 和 
Panicln 来 写 日 志 消 息 。 这 些 函 数 也 有 可 以 格式 化 消息 的 碑 本 ， 只 需要 
用 和 蔡 换 毕 ns Fatal 系列 函数 用 来 写 日 志 消 息 ， 然 后 使 
用 os .Exit(1) 终止 程序 。Panic 系列 函数 用 来 写 日 志 消 息 ， 然 后 触发 























一 个 panic 。 除 非 程 序 执行 recover 函数 ， 人 否则 会 导致 程序 打印 调用 栈 
后 终止 。Print 系列 函数 是 写 日 志 消 息 的 标准 方法 。 


1og 包 有 一 个 很 方便 的 地 方 就 是 ， 这 些 日 志 二 记录 喜 古 多 goroutine 安 
全 的 。 这 意味 着 在 多 个 goroutine 可 以 同时 调用 来 自 同 一 个 日 志 记 录 右 的 
这 些 函 数 ， 而 不 会 有 彼此 间 的 写 冲 突 。 标 准 日 志 记录 器 具有 这 一 性 质 ， 
用 户 定 制 的 日 志 记 录 器 也 应 该 满足 这 一 性 质 。 


现在 知道 了 如 何 使 用 和 配置 1og 包 ， 让 我 们 看 一 下 如 何 创建 一 个 定 
制 的 日 志 记 录 器 ， 以 便 可 以 让 不 同等 级 的 日 志 写 到 不 同 的 目的 地 。 


8.2.2 定制 的 日 志 忆 对 有 


要 想 创建 一 个 定制 的 日 志 记 录 器 ， 需 要 创建 一 个 Logger 类 型 值 。 
可 以 给 每 个 日 志 记 录 器 配置 一 个 单独 的 目的 地 ， 并 独立 设置 其 前 级 和 标 
志 。 让 我 们 来 看 一 个 示例 程序 ， 这 个 示例 程序 展示 了 如 何 创建 不 同 的 
Logger 类 型 的 指针 变量 来 支持 不 同 的 日 志 等 级 ， 如 代码 清单 8-11 所 
A 









































代码 清单 8-11 listing11.go 





























81 // 这 个 示例 程序 展示 如 何 创建 定制 的 日 志 记 录 咒 


62 package main 


03 

64 import ( 

05 "io" 

66 "io/ioutil" 
67 "log" 

68 "Os" 

69 ) 

10 

11 var ( 








12 Trace  *log.Logger // 记录 所 有 已 
13 Info  ”*]log.Logger // 重要 的 信息 

14 Warning *log.Logger // 需要 注意 的 信息 
15 Error  *]log.Logger // 非常 严重 的 问题 








16 ) 

17 

18 func init() { 

19 file, err := os.OpenFile("errors.txt", 

20 os.0_CREATE|os.0_NRONLY|os.0_APPEND，6666) 


21 if err != nil { 


22 log.Fatalln("Failed to open error log file:", err) 


23 } 

24 

25 Trace = log.New(ioutil.Discard, 

26 "TRACE: ”， 

27 log.Ldate|log.Ltime|log.Lshortfile) 

28 

29 Info = log.New(os.Stdout, 

36 "INFO: "， 

31 log.Ldate|log.Ltime|log.Lshortfile) 

32 

33 Warning = log.New(os.Stdout, 

34 "WARNING: "， 

35 log.Ldate|log.Ltime|log.Lshortfile) 

36 

37 Error = log.New(io.MultiWriter(file, os.Stderr), 
38 "ERROR: ”， 

39 log.Ldate|log.Ltime|log.Lshortfile) 

46 } 

41 

42 func main() { 

43 Trace.Println("I have something standard to say") 
44 Info.Println("Special Information") 

45 Warning.Println("There is something you need to know about") 
46 Error.Println("Something has failed") 

47 } 





代码 清单 8-11 展 示 了 一 段 完 整 的 程序 ， 这 上 段 程序 创建 了 4 种 不 同 的 
Logger 类 型 的 指针 变量 ， 分 别 命 名 为 Trace 、Info 、Warning 和 
Error 。 每 个 变量 使 用 不 同 的 配置 ， 用 来 表示 不 同 的 重要 程度 。 让 我 们 
来 分 析 一 下 这 段 代 码 是 如 何 工作 的 。 


在 第 11 行 到 第 16 行 ， 我 们 为 4 个 日 志 等 级 声明 了 4 个 Logger 类 型 的 
指针 变量 ， 如 代码 清单 8-12 所 示 。 











代码 清单 8-12 ”listing11.go: 第 11 行 到 第 16 行 

















11 var ( 

12 Trace  *]log.Logger // 记录 所 有 日 志 
13 Info  *log.Logger // 重要 的 信息 
14 Warning *log.Logger // 需要 注意 的 信息 














15 Error  *]log.Logger // 非常 严重 的 问题 
16 ) 





在 代码 清单 8-12 中 可 以 看 到 对 Logger 类 型 的 指针 变量 的 声明 。 我 
们 使 用 的 变量 名 很 简短 ， 但 是 含义 明确 。 接 下 来 ， 让 我 们 看 一 
下 init() 函数 的 代码 是 如 何 创 建 每 个 Logger 类 型 的 值 并 将 其 地 址 赋 给 
每 个 变量 的 ， 如 代码 清单 8-13 所 示 。 

















代码 清单 8-13 listing11.go: 第 25 行 到 第 39 行 

















Trace = log.New(ioutil.Discard, 
"TRACE : ”， 
log.Ldate|log.Ltime|log.Lshortfile) 


Info = log.New(os.Stdout, 
"INFO: ”， 
log.Ldate|log.Ltime|log.Lshortfile) 


Warning = log.New(os.Stdout, 
"WARNING: "， 
log.Ldate|log.Ltime|log.Lshortfile) 


Error = log.New(io.MultiWriter(file, os.Stderr), 
"ERROR: "， 
log.Ldate|log.Ltime|log.Lshortfile) 








为 了 创建 每 个 日 志 记 录 器 ， 我 们 使 用 了 1og 包 的 New 函数 ， 它 创建 
er 函数 New 会 返回 新 创建 的 值 的 地 

。 在 New 函数 创建 对 应 值 的 时 候 ， 我 们 需要 给 它 传 入 一 些 参 数 ， 如 代 
ee 单 8-14 所 示 。 




















代码 清单 8-14 golang.org/src/log/log.go 











// New 创 建 一 个 新 的 Logger。out 参 数 设 置 日 志 数 据 将 被 写 入 的 目的 地 
// 参数 prefix 会 在 生成 的 每 行 日 志 的 最 开始 出 现 
// 参数 flag 定 义 日 志 记录 包含 哪些 属性 























func New(out io.Writer, prefix string, flag int) *Logger { 
return &Logger{out: out, prefix: prefix, flag: flag} 


} 





代码 清单 8-14 展 示 了 来 自 log 包 的 源 代码 里 的 New 函数 的 声明 。 第 
一 个 参数 out 指定 了 日 志 要 写 到 的 目的 地 。 这 个 参数 传 入 的 值 必须 实现 
了 io.Writer 接口 。 第 二 个 参数 prefix 是 之 前 看 到 的 前 级 ， 而 日 志 的 








标志 则 是 最 后 一 个 参数 。 


在 这 个 程序 里 ，Trace 日 志 记 录 器 使 用 了 ioutil 包 里 的 Discard 
变量 作为 写 到 的 目的 地 ， 如 代码 清单 8-15 所 示 。 


代码 清单 8-15 listing11.go: 第 25 行 到 第 27 行 























Trace = log.New(ioutil.Discard, 
"TRACE: ”， 


log.Ldate|log.Ltime|log.Lshortfile) 





变量 Discard 有 一 些 有 意思 有 的 属性 ， 如 代码 清单 8-16 所 示 。 


代码 清单 8-16 golang.org/src/io/ioutil/ioutil.go 









































// devNull 是 一 个 用 
type devNull int 








// Discard 是 一 个 ijo.Writer， 所 有 的 Write 调 用 都 不 会 有 动作 ， 但 是 会 成 功 返 回 


var Discard io.Writer = devNu11(6) 











// io.Writer 接 口 的 实现 
func (devNull) Write(p []byte) (int, error) { 
return len(p), nil 


} 





代码 清单 8-16 展 示 了 Discard 变量 的 声明 以 及 相关 的 实 
现 。Discard 变量 的 类 型 被 声明 为 ijo.Writer 接口 类 型 ， 并 被 给 定 了 
一 个 devNull 类 型 的 值 0。 基 于 devNu11 类 型 实现 的 Write 方法， 会 忽 
略 所 有 写 入 这 一 变量 的 数据 。 当 某 个 等 级 的 日 志 不 重要 时 ， 使 
用 Discard 变量 可 以 禁用 这 个 等 级 的 日 志 。 


日 志 记 录 器 Info 和 Warning 都 使 用 stdout 作为 日 志 输 出 ， 如 代码 
清单 8-17 所 示 。 











代码 清单 8-17 listing11.go: 第 29 行 到 第 35 行 




















29 Info = log.New(os.Stdout, 
36 "INFO: "， 
31 log.Ldate|log.Ltime|log.Lshortfile) 


33 Warning = log.New(os.Stdout, 
34 "WARNING: "， 
35 log.Ldate|log.Ltime|log.Lshortfile) 





变量 stdout 的 声明 也 有 一 些 有 意思 的 地 方 ， 如 代码 清单 8-18 所 





代码 清单 8-18 golang.org/src/os/file.go 











// Stdin、Stdout 和 Stderr 是 已 经 打开 的 文件 ， 分 别 指向 标准 输入 、 标 准 输出 和 
// 标准 错误 的 文件 描述 符 
var ( 
Stdin NewFile(uintptr(syscall.Stdin), "/dev/stdin") 
Stdout = NewFile(uintptr(syscall.Stdout), "/dev/stdout") 
Stderr = NewFile(uintptr(syscall.Stderr), "/dev/stderr") 












































) 


os/file_ unix.go 





// NewFile 用 给 出 的 文件 描述 符 和 名 字 返 回 一 个 新 File 
func NewFile(fd uintptr, name string) *File { 














在 代码 清单 8-18 中 可 以 看 到 3 个 变量 的 声明 ， 分 别 表 示 所 有 操作 系 
统 里 都 有 的 3 个 标准 输入 /输出 ， 即 Stdin 、Stdout 和 Stderr 。 这 3 个 
变量 都 被 声明 为 File 类 型 的 指针 ， 这 个 类 型 实现 了 io.Writer 接口 。 
是 我 们 来 看 一 下 最 后 的 日 志 记 录 器 Error ， 如 代码 清单 8- 
19 所 示 。 














代码 清单 8-19 ”listing11.go: 第 37 行 到 第 39 行 

















Error = log.New(io.MultiWriter(file, os.Stderr), 
"ERROR: "， 


log.Ldate|log.Ltime|log.Lshortfile) 





在 代码 清单 8-19 中 可 以 看 到 New 函数 的 第 一 个 参数 来 自 一 个 特殊 的 
函数 。 这 个 特殊 的 函数 就 是 io 包 里 的 MultiWriter 函数 ， 如 代码 清单 
8-20 所 示 。 








代码 清单 8-20 包 io 里 的 MultiWriter 函数 的 声明 


io.MulLtiNriter(file，os.Stderr) 


代码 清单 8-20 单 独 展示 了 MultiWwriter 函数 的 调用 。 这 个 函数 调用 
会 返回 一 个 io.Writer 接口 类 型 值 ， 这 个 值 包含 之 前 打开 的 文件 file 
， 以 及 stderr 。MultiWriter 函数 是 一 个 变 参 函数 ， 可 以 接受 任意 个 
实现 了 io.Nriter 接口 的 值 。 这 个 函数 会 返回 一 个 ijo.Writer 值 ， 这 
个 值 会 把 所 有 传 入 的 io .Writer 的 值 绑 在 一 起 。 当 对 这 个 返回 值 进行 写 
入 时 ， 会 向 所 有 绑 在 一 起 的 io.WNriter 值 做 写 入 。 这 让 类 似 log .New 
这 样 的 函数 可 以 同时 向 多 个 Writer 做 输出 。 现 在 ， 当 我 们 使 用 Error 
记录 器 记录 日 志 时 ， 输 出 会 同时 写 到 文件 和 stderr 。 


现在 知道 了 该 如 何 创建 定制 的 记录 器 了 ， 让 我 们 看 一 下 如 何 使 用 这 
些 记 录 吉 来 写 日 志 消 轧 ， 如 代码 清单 8-21 所 示 。 


代码 清单 8-21 listing11.go: 第 42 行 到 第 47 行 









































42 func main() { 
43 Trace.Println("I have something standard to say") 
Info.Println("Special Information") 


Warning.Println("There is something you need to know about") 
Error.Println("Something has failed") 





代码 清单 8-21 展 示 了 代码 清单 8-11 中 的 main() 函数 。 在 第 43 行 到 
第 46 行 ， 我 们 用 自己 创建 的 每 个 记录 器 写 一 条 消息 。 每 个 记录 器 变量 都 
包含 一 组 方法 ， 这 组 方法 与 1og 包 里 实现 的 那 组 函数 完全 一 致 ， 如 代码 
清单 8-22 所 示 。 

代码 清单 8-22 展 示 了 为 Logger 类 型 实现 的 所 有 方法 。 


代码 清单 8-22 不同 的 日 志方 法 的 声明 























func (1 *Logger) Fatal(v ...interface{}) 

func (1 *Logger) Fatalf(format string, v ...interface{}) 
func (1 *Logger) Fatalln(v ...interface{}) 

func (1 *Logger) Flags() int 

func (1 *Logger) Output(calldepth int, s string) error 


func (1 *Logger) Panic(v ...interface{}) 

func (1 *Logger) Panicf(format string, v ...interface{}) 
func (1 *Logger) Panicln(v ...interface{}) 

func (1 *Logger) Prefix() string 

func (1 *Logger) Print(v ...interface{}) 

func (1 *Logger) Printf(format string, v ...interface{}) 
func (1 *Logger) Println(v ...interface{}) 

func (1 *Logger) SetFlags(flag int) 

func (1 *Logger) Setprefix(prefix string) 





8.2.3 ”结论 


log 包 的 实现 ， 是 基于 对 记录 日 志 这 个 需求 长 时 间 的 实践 和 积累 而 
形成 的 。 将 输出 写 到 stdout ， 将 日 志 记 录 到 stderr ， 是 很 多 基于 命令 
行 界 面 CLI) 的 程序 的 惯常 使 用 的 方法 。 不 过 如 果 你 的 程序 只 输出 日 
志 ， 那 么 使 用 stdout 、stderr 和 文件 来 记录 日 志 是 很 好 的 做 法 。 


标准 库 的 1og 包 包 含 了 记录 日 志 需 要 的 所 有 功能 ， 推 荐 使 用 这 个 
包 。 我 们 可 以 完全 信任 这 个 包 的 实现 ， 不 仅仅 是 因为 它 是 标准 库 的 一 部 
分 ， 而 且 社 区 也 广泛 使 用 它 。 


8.3 ”编码 /解码 


许多 程序 都 需要 处 理 或 者 发 布 数据 ， 不 管 这 个 程序 是 要 使 用 数据 
库 ， 进 行 网 络 调用 ， 还 是 与 分 布 式 系统 打交道 。 如 果 程 序 需要 处 理 
XML 或 者 JSON， 可 以 使 用 标准 库 里 名 为 xm1 和 json 的 包 ， 它 们 可 以 处 
理 这 些 格式 的 数据 。 如 果 想 实现 自己 的 数据 格式 的 编 解 码 ， 可 以 将 这 些 
包 的 实现 作为 指导 。 


在 今天 ，JSON 远 比 XML 流 行 。 这 主要 是 因为 与 XML 相 比 ， 使 用 
JSON 需 要 处 理 的 标签 更 少 。 而 这 就 意味 着 网 络 传输 时 每 个 消息 的 数据 
更 少 ， 从 而 提升 整个 系统 的 性 能 。 而 且 ，JSON 可 以 转换 为 
BSON (Binary JavaScript Object Notation， 二 进 制 JavaScript 对 象 标 
记 ) ， 进 一 步 缩 小 每 个 消息 的 数据 长 度 。 因 此 ， 我 们 会 学 习 如 何在 Go 
应 用 程序 里 处 理 并 发 布 JSON。 处 理 XML 的 方法 也 很 类 似 。 









































8.3.1 解 伺 JSON 


我 们 要 学 习 的 处 理 JSON 的 第 一 个 方面 是 ， 使 用 json 包 的 
NewDecoder 函数 以 及 Decode 方法 进行 解码 。 如 果 要 处 理 来 自 网 络 响 
应 或 者 文件 的 JSON， 那 么 一 定 会 用 到 这 个 函数 及 方法 。 让 我 们 来 看 一 
个 处 理 Get 请 求 啊 应 的 JSON 的 例子 ， 这 个 例子 使 用 http 包 获 取 Google 
搜索 API 返 回 的 JSON。 代 码 清单 8-23 展 示 了 这 个 啊 应 的 内 容 。 


代码 清单 8-23 ”Google 搜索 API 的 JSON 响 应 例子 








"responseData": { 
"results": |[ 


{ 


"GsearchResultClass": "GwebSearch", 
"unescapedUrl": "https://www.reddit.com/r/golang 


"url": "https://www.reddit.com/r/golang 


"visibleUrl": "www.reddit.com", 
"cacheUrl": "http://www.google.com/search?q=cache:W... 


"title": "Pr/N\u663cbNXu663eGolang\u663c/bN\u663e - Reddit", 
"titleNoFormatting": "r/Golang - Reddit", 
"content": "First Open Source Nu663cbNu663eGolangN\u...” 
}, 
{ 


"GsearchResultClass": "GwebSearch", 
"unescapedUrl": "http://tour.golang.org/ 


"url": "http://tour.golang.org/ 


"visibleUrl": "tour.golang.org", 
"cacheUrl": "http://www.google.com/search?q=cache:0... 


"title": "A Tour of Go", 
"titleNoFormatting": "A Tour of Go", 
"content": "Welcome to a tour of the Go programming ..." 


| 


ee 和 是 如 何 获 取 啊 应 并 将 其 解码 到 一 个 结构 类 型 里 
J 例 于 。 





代码 清单 8-24 listing24.go 














61 // 这 个 示例 程序 展示 如 何 使 用 json 包 和 NewDecoder 函 数 
62 // 来 解码 JSON 响 应 


63 package main 











064 

865 import ( 

66 "encoding/json" 

67 "fmt" 

68 "log" 

69 "net/http" 

16 ) 

11 

12 type ( 

13 // gResult 映 射 到 从 搜索 拿 到 的 结果 文档 

14 gResult struct { 

15 GsearchResultClass string ‘json:"GsearchResultClass". 
16 UnescapedURL string “json:"unescapedUrl". 
17 URL string “json:"url". 

18 VisibleURL string “json:"visibleUrl"、 
19 CacheURL string “json:"cacheUrl". 

20 Title string ‘json:"title" 

21 TitleNoFormatting string ‘json:"titleNoFormatting". 
22 Content string json:"content” 

23 } 

24 

25 // gResponse 包 含 顶 级 的 文档 

26 gResponse struct { 

27 ResponseData struct { 

28 Results []gResult “json:"results". 

29 } ‘json:"responseData". 

36 } 

31 ) 

32 

33 func main() { 

34 uri := “http://ajax.googleapis.com/ajax/services/search/web?v=1.6&r 


szZ=8&q=golang 





36 // 向 Google 发 起 搜索 








37 resp, err := http.Get(uri) 

38 if err != nil { 

39 log.Println("ERROR:", err) 
40 return 

41 } 

42 defer resp.Body.Close() 

43 

44 // 将 JSON 响 应 解码 到 结构 类 型 

45 var gr gResponse 

46 err = json.NewDecoder(resp.Body).Decode(&gr) 
47 if err != nil { 

48 log.Println("ERROR:", err) 
49 return 

56 } 

51 

52 fmt.Println(gr) 

53 } 








代码 清单 8-24 中 代码 的 第 37 行 ， 展示 了 程序 做 了 一 个 HTTP Get 调 
用 ,希望 从 Google 得 到 一 个 JSON 文 档 。 之 后 ， 在 第 46 行 使 
用 NewDecoder 函数 和 Decode 方法 ， 将 啊 应 返回 的 JSON 文 档 解 码 到 第 
26 行 声明 的 一 个 结构 类 型 的 变量 里 。 在 第 52 行 ， 将 这 个 变量 的 值 写 
到 stdout 。 


如 果 仔 细 看 第 26 行 和 第 14 行 的 gResponse 和 gResult 的 类 型 声 
明 ， 你 会 注意 到 每 个 字段 最 后 使 用 单 引 号 声明 了 一 个 字符 串 。 这 些 字 符 
串 被 称 作 标签 〈tag) ， 是 提供 每 个 字段 的 元 信息 的 一 种 机 制 ， 将 JSON 
文档 和 结构 类 型 里 的 字段 一 一 映射 起 来 。 如 果 不 存在 标签 ， 编 码 和 解 
码 过 程 会 试图 以 大 小 写 无 关 的 方式 ， 直 接 使 用 字段 的 名 字 进 行 匹 配 。 如 
果 无 法 匹配 ， 对 应 的 结构 类 型 里 的 字段 就 包含 其 零 值 。 


执行 HTTP Get 调用 和 解码 JSON 到 结构 类 型 的 具体 技术 细节 都 由 标 
准 库 包 办 了 。 让 我 们 看 一 下 标准 库 里 NewDecoder 函数 和 Decode 方法 
的 声明 ， 如 代码 清单 8-25 所 示 。 











代码 清单 8-25 golang.org/src/encoding/json/stream.go 








// NewDecoder 返 回 从 r 读 取 的 解码 器 
// 
// 解码 器 自己 会 进行 缓冲 ， 而 且 可 能 会 从 r 读 比 解码 JSON 值 





























// 所 需 的 更 多 的 数据 


func NewDecoder(r io.Reader) *Decoder 








// Decode 从 自己 的 输入 里 读 取 下 一 个 编码 好 的 JSON 值 ， 
// 并 存 入 v 所 指向 的 值 里 

// 
// 要 知道 从 JSON 转 换 为 Go 的 值 的 细节 ， 
// 请 查看 Unmarshal 的 文档 
func (dec *Decoder) Decode(v interface{}) error 


















































在 代码 清单 8-25 中 可 以 看 到 NewDecoder 函数 接受 一 个 实现 了 
io.Reader 接口 类 型 的 值 作为 参数 。 在 下 一 节 ， 我 们 会 更 详细 地 介绍 
io.Reader 和 io.Writer 接口 ， 现 在 只 需要 知道 标准 库 里 的 许多 不 同 





类 型 ， 包 括 http 包 里 的 一 些 类 型 ， 都 实现 了 这 些 接口 就 行 。 只 要 类 型 
实现 了 这 些 接口 ， 惑 可 以 自动 获得 许多 功能 的 支持 。 


函数 NewDecoder 返回 一 个 指 癌 Decoder 类 型 的 指针 值 。 由 于 Go 语 
言 文 持 复合 语句 调用 ， 可 以 直接 调用 从 NewDecoder 函数 返回 的 值 的 
Decode 方法 ， 而 不 用 把 这 个 返回 值 存 入 变量 。 在 代码 清单 8-25 里 ， 可 
以 看 到 Decode 方法 接受 一 个 interface{} 类 型 的 值 做 参数 ， 并 返回 一 


个 error 值 。 


在 第 5 间 中 曾 讨论 过 ， 任 何 类 型 都 实现 了 一 个 空 接口 jnterfacef{} 
。 这 意味 着 Decode 方法 可 以 接受 任意 类 型 的 值 。 使 用 反射 ，Decode 方 
法 会 拿 到 传 入 值 的 类 型 信息 。 然 后 ， 在 读 取 JSON 啊 应 的 过 程 
中 ，Decode 方法 会 将 对 应 的 啊 应 解码 为 这 个 类 型 的 值 。 这 意味 着 用 户 
ee Decode 会 为 用 户 做 这 件 事情 ， 如 代码 清单 8-26 
未 


在 代码 清单 8-26 中 ， 我 们 向 Decode 方法 传 入 了 指向 gResponse 类 
型 的 指针 变量 的 地 址 ， 而 这 个 地 址 的 实际 值 为 nil 。 该 方法 调用 后 ， 这 
个 指针 变量 会 被 赋 给 一 个 gResponse 类 型 的 值 ， 并 根据 解码 后 的 JSON 
文档 做 初始 化 。 









































代码 清单 8-26 ”使 用 Decode 方法 


var gr *gResponse 
err = json.NewDecoder(resp.Body).Decode(&gr) 








有 时 ， 需 要 处 理 的 JSON 文 档 会 以 string 的 形式 存在 。 在 这 种 情况 
下 ， 需 要 将 string 转换 为 byte 切片 〈[]byte ) ， 并 使 用 json 包 的 
Unmarshal 函数 进行 反 序 列 化 的 处 理 ， 如 代码 清单 8-27 所 示 ， 


代码 清单 8-27 listing27.go 

















61 // 这 个 示例 程序 展示 如 何 解 码 JSON 字 符 串 
62 package main 





03 

684 import ( 

65 "encoding/json" 
66 "fmt" 

67 "log" 

68 ) 

69 





16 // Contact 结 构 代 表 我 们 的 JSON 字 符 串 
11 type Contact struct { 


12 Name string ‘json:"name". 
13 Title string “json:"title". 
14 Contact struct { 

15 Home string “json:"home". 
16 Cell string ‘json:"cell". 
17 } “json:"contact". 

18 } 

19 


26 // JSON 包 含 用 于 反 序 列 化 的 演示 字符 串 
21 var JSON= `{ 


22 "name": "Gopher", 

23 "title": "programmer", 

24 "contact": { 

25 "home": "415.333.3333", 
26 "cell": "415.555.5555" 
27 } 

28 小 

29 


36 func main() { 
31 // 将 JSON 字 符 串 有 反 序列 化 到 变量 





32 Var c Contact 

33 err := json.Unmarshal([]jbyte(JSON) ，&c ) 
34 if err != nil { 

35 log.Println("ERROR:", err) 

36 return 

37 } 

38 

39 fmt.Println(c) 


46 } 


[L 


在 代码 清单 8-27 中 ， 我 们 的 例子 将 JSON 文 档 保存 在 一 个 字符 串 变 
量 里 ， 并 使 用 Unmarshal 函数 将 JSON 文 档 解码 到 一 个 结构 类 型 的 值 
里 。 如 果 运 行 这 个 程序 ， 会 得 到 代码 清单 8-28 所 示 的 输出 。 

















代码 清和 








8-28 listing27.go 的 输出 


{Gopher programmer {415.333.3333 415.555.5555}} 





有 时 ， 无 法 为 JSON 的 格式 声明 一 个 结构 类 型 ， 而 是 需要 更 加 灵活 
的 方式 来 处 理 JSON 文 档 。 在 这 种 情况 下 ， 可 以 将 JSON 文 档 解 码 到 一 


个 map 变量 中 ， 如 代码 清单 8-29 所 示 。 





代码 清单 8-29 listing29.go 














861 // 这 个 示例 程序 展示 如 何 解码 JSON 字 符 串 
62 package main 





03 

84 import ( 

65 "encoding/json" 
66 "fmt" 

67 "log" 

68 ) 

69 





ny 





16 // JSON 包 含 要 反 序 列 化 的 样 例 字符 有 
11 var JSON = 1{ 





12 "name": "Gopher", 

13 "title": "programmer", 

14 "contact": { 

15 "home": "415.333.3333", 
16 "cell": "415.555.5555" 
17 } 

18 小 

19 


26 func main() { 
21 // 将 JSON 字 符 串 反 序列 化 到 map 变 量 





22 var c map[string]interface{} 

23 err := json.Unmarshal([]jbyte(JSON) ，&c ) 
24 if err != nil { 

25 log.Println("ERROR:", err) 

26 return 


29 fmt.Println("Name:", c["name"]) 

30 fmt.Println("Title:", c["title"]) 

31 fmt.Println("Contact") 

32 fmt.Println("H:", c["contact"].(map[string]interface{})["home"]) 
33 fmt.Println("C:", c["contact"].(map[string]interface{})["cell"]) 
34 } 





代码 清单 8-29 中 的 程序 修改 目 代 码 清单 8-27， 将 其 中 的 结构 类 型 变 








量 蔡 换 为 map 类 型 的 变量 。 变 量 c 声明 为 一 个 map 类 型 ， 其 键 是 string 
类 型 ， 其 值 是 interface{} 类 型 。 这 意味 着 这 个 map 类 型 可 以 使 用 任意 
类 型 的 值 作为 给 定 键 的 值 。 虽 然 这 种 方法 为 处 理 JSON 文 档 带 来 了 很 大 

的 灵活 性 ， 但 是 却 有 一 个 小 缺点 。 让 我 们 看 一 下 访问 contact 子 文档 的 
home 字段 的 代码 ， 如 代码 清单 8-30 所 示 。 


代码 清单 8-30 ”访问 解 组 后 的 映射 的 字段 的 代码 





























fmt.Println("\tHome:", c["contact"].(map[string]interface{})["home"]) 





因为 每 个 键 的 值 的 类 型 都 是 jnterface{} ， 所 以 必须 将 值 转换 为 
合适 的 类 型 ， 才 能 处 理 这 个 值 。 代 码 清单 8-30 展 示 了 如 何 将 contact 键 
的 值 转换 为 另 一 个 键 是 string 类 型 ， 值 是 ijnterface{} 类 型 的 map 类 
型 。 这 有 时 会 使 映射 里 包含 另 一 个 文档 的 JSON 文 档 处 理 起 来 不 那么 友 
好 。 但 是 ， 如 果 不 需要 深入 正在 处 理 的 JSON 文 档 ， 或 者 只 打算 做 很 少 
的 处 理 ， 因 为 不 需要 声明 新 的 类 型 ， 使 用 map 类 型 会 很 快 。 





8.3.2 ”编码 JSON 


我 们 要 学 习 的 处 理 JSON 的 第 二 个 方面 是 ， 使 用 json 包 的 
MarshalIndent 函数 进行 编码 。 这 个 函数 可 以 很 方便 地 将 Go 语言 的 
map 类 型 的 值 或 者 结构 类 型 的 值 转换 为 易 读 格式 的 JSON 文 档 。 序 列 化 

(marshal) 是 指 将 数据 转换 为 JSON 字 符 串 的 过 程 。 下 面 是 一 个 将 map 
类 型 转换 为 JSON 字 符 串 的 例子 ， 如 代码 清单 8-31 所 示 。 


代码 清单 8-31 listing31.go 




















81 // 这 个 示例 程序 展示 如 何 序列 化 JSON 字 符 串 
62 package main 





64 import ( 

65 "encoding/json" 
66 "fmt" 

67 "log" 

68 ) 

69 


16 func main() { 
11 // 创建 一 个 保存 键 值 对 的 映射 





12 c := make(map[string]interface{}) 

13 c[ “name"] = "Gopher" 

14 c["title"] = "programmer" 

15 c["contact"] = map[string]interface{}{ 
16 "home": "415.333.3333", 

17 "cell": "415.555.5555", 

18 } 

19 

26 // 将 这 个 映射 序列 化 到 ]SON 字 符 串 

21 data, err := json.MarshalIndent(c, "", " ") 
22 if err != nil { 

23 log.Println("ERROR:", err) 

24 return 

25 } 

26 

27 fmt.Println(string(data)) 

28 } 





代码 清单 8-31 展 示 了 如 何 使 用 json 包 的 MarshalIndent 函数 将 一 
个 map 值 转换 为 JSON 字 符 串 。 函 数 MarshalIndent 返回 一 个 byte 切 
片 ， 用 来 保存 JSON 字 符 串 和 一 个 error 值 。 下 面 来 看 一 下 json 包 中 
MarshalIndent 函数 的 声明 ， 如 代码 清单 8-32 所 示 。 


代码 清单 8-32 golang.org/src/encoding/json/encode.go 











// MarshalIndent 很 像 Marshal， 只 是 用 缩 进 对 输出 进行 格式 化 


func MarshalIndent(v interface{}, prefix, indent string) ([]byte，error) { 





在 MarshalIndent 函数 里 再 一 次 看 到 使 用 了 空 接口 类 型 
interface{f} 。 子 数 MarshalIndent 会 使 用 反射 来 确定 如 何 将 map 类 
型 转换 为 JSON 字 符 串 。 


如 果 不 需 要 输出 带 有 缩 进 格式 的 JSON 字 符 串 ，json 包 还 提供 了 名 


为 Marshal 的 函数 来 进行 解码 。 这 个 函数 产生 的 JSON 字 符 串 很 适合 作 
为 在 网 络 响应 (如 Web API) 的 数据 。 函 数 Marshal 的 工作 原理 和 函 

数 MarshalIndent 一 样 ， 只 不 过 没有 用 于 前 级 prefix 和 缩 进 indent 
的 参数 。 


8&39、 二 I 


在 标准 库 里 都 已 经 提供 了 处 理 JSON 和 XML 格式 所 需要 的 诸如 解 
码 、 反 序列 化 以 及 序列 化 数据 的 功能 。 随 着 每 次 Go 语言 新 版 本 的 发 
布 ， 这 些 包 的 执行 速度 也 越 来 越 快 。 这 些 包 是 处 理 JSON 和 XML 的 最 佳 
选择 。 由 于 有 反射 包 和 标签 的 文 持 ， 可 以 很 方便 地 声明 一 个 结构 类 型 ， 
并 将 其 中 的 字段 映射 到 需要 处 理 和 发 布 的 文档 的 字段 。 由 于 json 包 和 
xml 包 都 支持 io.Reader 和 io.Writer 接口 ， 用 户 不 用 担心 自己 的 
JSON 和 XML 文档 源 于 哪里 。 所 有 的 这 些 特性 都 让 处 理 JSON 和 XML 变 
得 很 容易 。 


8.4 输入 和 输出 


类 UNIX 的 操作 系统 如 此 伟大 的 一 个 原因 是 ， 一 个 程序 的 输出 可 以 
是 另 一 个 程序 的 输入 这 一 理念 。 依 照 这 个 哲学 ， 这 类 操作 系统 创建 了 一 
系列 的 简单 程序 ， 每 个 程序 只 做 一 件 事 ， 并 把 这 件 事 做 得 非常 好 。 之 
后 ， 将 这 些 程序 组 合 在 一 起 ， 可 以 创建 一 些 脚 本 做 一 些 很 惊艳 的 事情 。 
这 些 程序 使 用 stdin 和 stuout 设备 作为 通道 ， 在 进程 之 间 传 递 数据 。 


同样 的 理念 扩展 到 了 标准 库 的 io 包 ， 而 且 提 供 的 功能 很 神奇 。 这 
个 包 可 以 以 流 的 方式 高 效 处 理 数 据 ， 而 不 用 考虑 数据 是 什么 ， 数 据 来 自 
哪里 ， 以 及 数据 要 发 送 到 哪里 的 问题 。 与 stuout 和 stdin 对 应 ， 这 个 
包含 有 io.Writer 和 io.Reader 两 个 接口 。 所 有 实现 了 这 两 个 接口 的 
类 型 的 值 ， 都 可 以 使 用 io 包 提 供 的 所 有 功能 ， 也 可 以 用 于 其 他 包 里 接 
受 这 两 个 接口 的 函数 以 及 方法 。 这 是 用 接口 类 型 来 构造 函数 和 API 最 美 
妙 的 地 方 。 开 发 人 员 可 以 基于 这 些 现 有 功能 进行 组 合 ， 利 用 所 有 已 经 存 
在 的 实现 ， 专 注 于 解决 业务 问题 。 


有 了 这 个 概念 ， 让 我 们 先 看 一 下 io.Wrtier 和 io.Reader 接口 的 
声明 ， 然 后 再 来 分 析 展 示 了 io 包 神 奇 功能 的 代码 。 














8.4.1 Writer 和 Reader 接 口 


io 包 是 围绕 着 实现 了 io.Writer 和 io.Reader 接口 类 型 的 值 而 构 
建 的 。 由 于 io.Writer 和 io.Reader 提供 了 足够 的 抽象 ， 这 些 io 包 里 
的 函数 和 方法 并 不 知道 数据 的 类 型 ， 也 不 知道 这 些 数据 在 物理 上 是 如 何 
的 。 让 我 们 先 来 看 一 下 io .Writer 接口 的 声明 ， 如 代码 清单 8-33 

下 




















代码 清单 8-33 io.Nriter 接口 的 声明 





type Writer interface { 
Write(p []byte) (Cn int, err error) 





代码 清单 8-33 展 示 了 io.Writer 接口 的 声明 。 这 个 接口 声明 了 唯一 
一 个 方法 Write ， 这 个 方法 接受 一 个 byte 切片 ， 并 返回 两 个 值 。 第 一 
个 值 是 写 入 的 字 节 数 ， 第 二 个 值 是 error 错误 值 。 代 码 清单 8-34 给 出 的 
是 实现 这 个 方法 的 一 些 规则 。 








代码 清单 8-34 io.Writer 接口 的 文档 























Write 从 p 里 向 底层 的 数据 流 写 入 len(p) 字 节 的 数据 。 这 个 方法 返回 从 p 里 写 出 的 字 节 
数 (6 <= n <= len(p)) ， 以 及 任何 可 能 导致 号 入 提前 结束 的 错误 。Write 在 返回 n 























< len(p) 的 时 候 ， 必 须 返 回 某 个 非 nil 值 的 error。Write 绝 不 能 改写 切片 里 的 数据 ， 
哪怕 是 临时 修改 也 不 行 。 











代码 清单 8-34 中 的 规则 来 自 标准 库 。 这 些 规则 意味 着 Write 方法 的 
实现 需要 试图 写 入 被 传 入 的 byte 切片 里 的 所 有 数据 。 但 是 ， 如 果 无 法 
全 部 写 入 ， 那 么 该 方法 就 一 定 会 返回 一 个 错误 。 返 回 的 写 入 字 节 数 可 能 
会 小 于 byte 切片 的 长 度 ， 但 不 会 出 现 大 于 的 情况 。 最 后 ， 不 管 什么 情 
况 ， 都 不 能 修改 byte 切片 里 的 数据 。 


让 我 们 看 一 下 Reader 接口 的 声明 ， 如 代码 清单 8-35 所 示 。 


代码 清单 8-35 io.Reader 接口 的 声明 





























type Reader interface { 
Read(p []byte) (Cn int, err error) 





代码 清单 8-35 中 的 io .Reader 接口 声 明了 一 个 方法 Read ， 这 个 方 
法 接受 一 个 byte 切片 ， 并 返回 两 个 值 。 第 一 个 值 是 读 入 的 字 节 数 ， 第 
eo 错误 值 。 代 码 清单 8-36 给 出 的 是 实现 这 个 方法 的 一 些 规 
则 。 








代码 清单 8-36 io.Reader 接口 的 文档 











(1) Read 最 多 读 入 len(p) 字 节 ， 保 存 到 p。 这 个 方法 返回 读 入 的 字 节 数 (86 <= n 
<= len(p)) 和 任何 读 取 时 发 生 的 错误 。 即 便 Read 返 回 的 n < len(p)， 方 法 也 可 
能 使 用 所 有 p 的 空间 存储 临时 数据 。 如 果 数 据 可 以 读 取 ， 但 是 字 节 长 度 不 足 len(p)， 
习惯 上 Read 会 立刻 返回 可 用 的 数据 ， 而 不 等 待 更 多 的 数据 。 




































































(2) 当成 功 读 取 n > 6 字 节 后 ， 如 果 遇 到 错误 或 者 文件 读 取 完成 ，Read 方 法 会 返回 
读 入 的 守节 数 。 方法 可 能 会 在 本 次 调用 返回 一 个 非 nil 的 错误 ， 或 者 在 下 一 次 调 用 时 返 
回 错 误 〈 同 时 n == 6) 。 de 个 例子 是 ， 在 输入 的 流 结束 时 ，Read 会 返回 
非 零 的 读 取 字 节 数 ， 可 能 会 返回 err == EOF， 也 可 能 会 返回 err == nil。 无论 如 何 ， 
下 一 次 调用 Read 应 该 返回 9，EOF。 













































































(3) 调用 者 在 返回 的 n > 6 时， 总 应 该 先 处 理 读 入 的 数据 ， 再 处 理 错误 err。 这 样 
能 正确 操作 读 取 一 部 分 字 节 后 发 生 的 I/0 错 误 。 EOF 也 要 这 样 处 理 。 






























































(4) Read 的 实现 不 鼓励 返回 6 个 读 取 字 节 的 同时 ， 返 回 nil 值 的 错误 。 调 月 
这 种 返回 状态 视 为 没有 做 任何 操作 ， 2 吉 束 。 























标准 库 里 列 出 了 实现 Read 方法 的 4 条 规则 。 第 一 条 规则 表明 ， 
现 需 要 试图 读 取 数据 来 填 满 被 传 入 的 byte 切 厂 。 人 的 字 
数 小 于 byte 切片 的 长 度 ， | 己 经 读 到 数据 但 是 数据 不 
切片 时 ， 不 应 该 等 待 新 数据 ， 而 是 要 直接 返回 已 读数 





第 二 条 规则 提供 了 应 该 如 何 处 理 达到 文件 末尾 (EOF ) 的 情况 的 指 
导 。 当 读 到 最 后 一 个 字 节 时 ， 可 以 有 两 种 选择 。 一 种 是 Read 返回 最 终 
读 到 的 字 节 数 ， 并 且 返 回 EOF 作为 错误 值 ， 另 一 种 是 返回 最 终 读 到 的 字 
节 数 ， 并 返回 nil 作为 错误 值 。 在 后 一 种 情况 下 ， 下 一 次 读 取 的 时 候 ， 
由 于 没有 更 多 的 数据 可 供 读 取 ， 需 要 返回 0 作为 读 到 的 字 节 数 ， 以 及 EOF 
作为 错误 值 。 


第 三 条 规则 是 给 调用 Read 的 人 的 建议 。 任 何 时 候 Read 返回 了 读 取 
的 字 节 数 ， ee 再 去 检查 EOF 错 误 值 或 
者 其 他 错误 值 。 最 终 ， 第 四 条 约束 建议 Read 方法 的 实现 永远 不 要 返回 0 





个 读 取 字 节 的 同时 返回 nil 作为 错误 值 。 如 果 没 有 读 到 值 ，Read 应 该 


总 是 返回 一 个 错误 I 大。 

现在 知道 了 io.Writer 和 io.Reader 接口 是 什么 样子 的 ， 以 及 期 
I 让 我 们 看 一 下 如 何在 程序 里 使 用 这 些 接口 以 及 io 
8.4.2 ”整合 并 完成 工作 

这 个 例子 展示 标准 库 里 不 同 包 是 如 何 通过 支持 实现 了 io .Writer 接 
口 类 型 的 值 来 一 起 完成 工作 的 。 这 个 示例 里 使 用 了 bytes 、fmt 和 os 
包 来 进行 缓冲 、 拼 接 和 写字 符 串 到 stuout ， 如 代码 清单 8-37 所 示 。 


代码 清单 8-37 listing37.go 























// 这 个 示例 程序 展示 来 自 不 同 标准 库 的 不 同 函数 是 如 何 
// 使 用 io.Writer 接 口 的 


package main 








import ( 
"bytes" 
"fmt" 
"oc" 


) 
// main 是 应 用 程序 的 入 口 


func main() { 
// 创建 一 个 Buffer 值 ， 并 将 一 个 字符 串 写 入 Buffer 
// 使 用 实现 io.Writer 的 Write 方 法 
var b bytes.Buffer 
b.Write([]byte("Hello ")) 





























// 使 用 Fprintf 来 将 一 个 字符 串 拼 接 到 Buffer 里 
// 将 bytes.Buffer 的 地 址 作为 io .Writer 类 型 值 传 入 
fmt.Fprintf(&b, "World!") 











// 将 Buffer 的 内 容 输 出 到 标准 输出 设备 
// 将 os .File 值 的 地 址 作为 io .Writer 类 型 值 传 入 
b.WriteTo(os.Stdout) 











运行 代码 清单 8-37 中 的 程序 会 得 到 代码 清单 8-38 所 示 的 输出 。 














代码 清单 8-38 listing37.go 的 输出 


Hello World! 


这 个 程序 使 用 了 标准 库 的 3 个 包 来 将 "Hello World!" 输出 到 终端 
窗口 。 一 开始 ， 程 序 在 第 15 行 声明 了 一 个 bytes 包 里 的 Buffer 类 型 的 
变量 ， 并 使 用 零 值 初始 化 。 在 第 16 行 创建 了 一 个 byte 切片 ， 并 用 字符 
串 "Hello" 初始 化 了 这 个 切片 。byte 切片 随后 被 传 入 Write 方法 ， 成 
为 Buffer 类 型 变量 里 的 初始 内 容 。 


第 20 行 使 用 fmt 包 里 的 Fprintf 函数 将 字符 串 "Nor1d!" 追加 
到 Buffer 类 型 变量 里 。 让 我 们 看 一 下 Fprintf 函数 的 声明 ， 如 代码 清 
单 8-39 所 示 。 

















代码 清单 8-39 golang.org/src/fmt/print.go 














// Fprintf 根 据 格式 化 说 明 符 来 格式 写 入 内 容 ， 并 输出 到 Ww 
// 这 个 函数 返回 写 入 的 字 节 数 ， 以 及 任何 遇 到 的 错误 








func Fprintf(w io.Writer, format string, a ...interface{}) (Cn int，err err 
or) 





需要 注意 Fprintf 函数 的 第 一 个 参数 。 这 个 参数 需要 接收 一 个 实现 
了 io.Writer 接口 类 型 的 值 。 因 为 我 们 传 入 了 之 前 创建 的 Buffer 类 型 
值 的 地 址 ， 这 意味 着 bytes 包 里 的 Buffer 类 型 必须 实现 了 这 个 接口 。 
那么 在 bytes 包 的 源 代码 里 ， 我 们 应 该 能 找到 为 Buffer 类 型 声明 的 
Write 方法 ， 如 代码 清单 8-40 所 示 。 














代码 清单 8-40 golang.org/src/bytes/buffer.go 

















// Write 将 p 的 内 容 妃 加 到 缓冲 区 ， 如 果 需 要 ， 会 增 大 缓冲 区 的 空间 。 返 回 值 

// p 的 长 度 ，err 总 是 ni1。 如 果 绥 冲 区 变 得 太 大 ，Write 会 引起 崩溃 . 

func (b *Buffer) Write(p []byte) (n int, err error) { 
b.lastRead = opInvalid 


























m := b.grow(len(p)) 
return copy(b.buf[m:], p), nil 


} 





代码 清单 8-40 展 示 了 Buffer 类 型 的 Write 方法 的 当前 版 本 的 实 





现 。 由 于 实现 了 这 个 方法 ， 指 向 Buffer 类 型 的 指针 就 满足 了 
io.Writer 接口 ， 可 以 将 指针 作为 第 一 个 参数 传 入 Fprintf 。 在 这 个 
例子 里 ， es 函数 ， 最 终 通过 Buffer 实现 的 Nrite 方 
法 ， 将 "World!" 字符 串 追 加 到 Buffer 类 型 变量 的 内 部 缓冲 区 。 


让 我 们 看 一 下 代码 清单 8-37 的 最 后 几 行 ， 如 代码 清单 8-41 所 示 ， 将 
整个 Buffer 类 型 变量 的 内 容 写 到 stuout 。 


代码 清单 8-41 listing37.go: 第 22 行 到 第 25 行 














22 // 将 Buffer 的 内 容 输出 到 标准 输出 设备 
23 // 将 os.File 值 的 地 址 作为 io .Nriter 类 型 值 传 入 








24 b.WriteTo(os.Stdout) 
25 } 





在 代码 清单 8-37 的 第 24 行 ， 使 用 WriteTo 方法 将 Buffer 类 型 的 变 
量 的 内 容 写 到 stuout 设备 。 这 个 方法 接受 一 个 实现 了 io.Writer 接口 
i ER 传 入 的 值 是 os 包 的 Stdout 变量 的 值 ， 如 代码 清 
音 8-42 所 示 。 





代码 清单 8-42 golang.org/src/os/file.go 





var ( 
Stdin NewFile(uintptr(syscall.Stdin), "/dev/stdin") 
Stdout = NewFile(uintptr(syscall.Stdout), "/dev/stdout") 
Stderr = NewFile(uintptr(syscall.Stderr), "/dev/stderr") 





这 些 变 量 自动 声明 为 NewFile 函数 返回 的 类 型 ， 如 代码 清单 8-43 所 





代码 清单 8-43 golang.org/src/os/file_unix.go 














// NewFile 返 回 一 个 具有 给 定 的 文件 描述 符 和 名 字 的 新 File 
func NewFile(fd uintptr, name string) *File { 
fdi := int(fd) 
if fdi < 8@f{ 
return nil 








} 
f := &File{&file{fd: fdi, name: name}} 


runtime.SetFinalizer(f.file, (*file).close) 
return f 








就 像 在 代码 清单 8-43 里 看 到 的 那样 ，NewFile 函数 返回 一 个 指 
向 File 类 型 的 指针 。 这 就 是 stdout 变量 的 类 型 。 既 然 我 们 可 以 将 这 个 
类 型 的 指针 作为 参数 传 入 WriteTo 方法 ， 那 么 这 个 类 型 一 定 实现 了 
io.Writer 接口 。 在 os 包 的 源 代 码 里 ， 我 们 应 该 能 找到 Write 方法 ， 
如 代码 清单 8-44 所 示 。 








代码 清单 8-44 golang.org/src/os/file.go 





// Write 将 len(b) 个 字 节 写 入 File 
// 这 个 方法 返回 写 入 的 字 节 数 ， 如 果 有 错误 ， 也 会 返回 错误 
// 如 果 n != len(b)，Write 会 返回 一 个 非 nil 的 错误 
func (f *File) Write(b []byte) (Cn int, err error) { 
if f == nil { 
return 06, ErrIinvalid 


} 


n, e := f.write(b) 


























n = 0 


} 
if n != len(b) { 
err = io.ErrShortWrite 


} 


epipecheck(f, e) 
ife != nil { 
err = &PathError{"write", f.name, e} 


} 


return n, err 





没 错 ， 代 码 清 单 8-44 中 的 代码 展示 了 File 类 型 指针 实现 
io.Writer 接口 类 型 的 代码 。 让 我 们 再 看 一 下 代码 清单 8-37 的 第 24 行 ， 
如 代码 清单 8-45 所 示 。 














代码 清单 8-45 ”listing37.go: 第 22 行 到 第 25 行 














22 // 将 Buffer 的 内 容 输出 到 标准 输出 设备 
23 // 将 os .File 值 的 地 址 作为 io.Writer 类 型 值 传 入 








24 b.WriteTo(os .Stdout ) 
25 } 


可 以 看 到 ，WriteTo 方法 可 以 将 Buffer 类 型 变量 的 内 容 写 
到 stuout ， 结 果 就 是 在 终端 窗口 上 显示 了 "Hello World!" 字符 串 。 
这 个 方法 会 通过 接口 值 ， 调 用 File 类 型 实现 的 Write 方法 。 


这 个 例子 展示 了 接口 的 优雅 以 及 它 带 给 语言 的 强大 的 能 力 。 得 益 于 
bytes.Buffer 和 os.File 类 型 都 实现 了 Writer 接口 ， 我 们 可 以 使 用 
标准 库 里 已 有 的 功能 ， 将 这 些 类 型 组 合 在 一 起 完成 工作 。 接 下 来 让 我 们 
看 一 个 更 加 实用 的 例子 。 





8.4.3 ”简单 的 curl 


在 Linux 和 MacOS ( 曾 用 名 Mac OS X) 系统 里 可 以 找到 一 个 名 
为 curl 的 命令 行 工 具 。 这 个 工具 可 以 对 指定 的 URL 发 起 HTTP 请 求 ， 并 
保存 返回 的 内 容 。 通 过 使 用 http 、io 和 os 包 ， 我 们 可 以 用 很 少 的 几 行 
代码 来 实现 一 个 自己 的 curl 工具 。 


让 我 们 来 看 一 下 实现 了 基础 curl 功能 的 例子 ， 如 代码 清单 8-46 所 








代码 清单 8-46 listing46.go 














61 // 这 个 示例 程序 展示 如 何 使 用 io.Reader 和 io.Writer 接 口 
62 // 写 一 个 简单 版 本 的 curl 


63 package main 





64 

65 import ( 

66 "io 

87 "log" 

68 "net/http" 
69 "OS" 

16 ) 

11 





12 // main 是 应 用 程序 的 入 口 
13 func main() { 





























14 // 这 里 的 r 是 一 个 响应 ，r.Body 是 io.Reader 
15 r, err := http.Get(os.Args[1]) 
16 if err != nil { 


17 log.Fatalln(err) 


18 } 








19 

26 // 创建 文件 来 保存 响应 内 容 

21 file, err := os.Create(os.Args[2]) 
22 if err != nil { 

23 log.Fatalln(err) 

24 } 

25 defer file.Close() 

26 








27 。 // 使 用 MultiWriter， 这 样 就 可 以 同时 向 文件 和 标准 输出 设备 
28  ”// 进行 写 操作 

















29 dest := io.MultiWriter(os.Stdout, file) 
30 

31 // 读 出 响应 的 内 容 ， 并 写 到 两 个 目的 地 

32 io.Copy(dest, r.Body) 

33 if err := r.Body.Close(); err != nil { 
34 log.Println(err) 

35 

36 } 





代码 清单 8-46 展 示 了 一 个 实现 了 基本 骨架 功能 的 curl ， 它 可 以 下 
载 、 展 示 并 保存 任意 的 HITP Get 请 求 的 内 容 。 这 个 例子 会 将 啊 应 的 结 
果 同 时 写 入 文件 以 及 stuout 。 为 了 让 例子 保持 简单 ， 这 个 程序 没有 检 





查 命令 行 输入 参数 的 有 效 性 ， 也 没有 支持 更 高 级 的 选项 。 


在 这 个 程序 的 第 15 行 ， 使 用 来 自命 令 行 的 第 一 个 参数 来 执行 HTTP 
Get 请 求 。 如 果 这 个 参数 是 一 个 URL， 而 且 请 求 没有 发 生 错 误 ， 变 量 r 
里 就 包含 了 该 请 求 的 啊 应 结果 。 在 第 21 行 ， 我 们 使 用 命令 行 的 第 二 个 参 
数 打开 了 一 个 文件 。 如 果 这 个 文件 打开 成 功 ， 那 么 在 第 25 行 会 使 
用 defer 语句 安排 在 函数 退出 时 执行 文件 的 关闭 操作 。 


因为 我 们 希望 同时 间 stuout 和 指定 的 文件 里 写 请 求 的 内 容 ， 所 以 
在 第 29 行 我 们 使 用 io 包 里 的 MultiWriter 函数 将 文件 和 stuout 整合 为 
一 个 io.Writer 值 。 在 第 33 行 ， 我 们 使 用 io 包 的 Copy 函数 从 啊 应 的 结 
果 里 读 取 内 容 ， 并 写 入 两 个 目的 地 。 由 于 有 MultiWriter 函数 提供 的 
值 的 支持 ， 我 们 可 使 用 一 次 Copy 调用 ， 将 内 容 同 时 写 到 两 个 目的 地 。 


利用 io 包 里 已 经 提供 的 文 持 ， 以 及 http 和 os 包 里 已 经 实现 了 
io.Writer 和 io.Reader 接口 类 型 的 实现 ， 我 们 不 需要 编写 任何 代码 
来 完成 这 些 底层 的 函数 ， 借 助 已 经 存在 的 功能 ， 将 注意 力 集中 在 需要 解 
决 的 问题 上 。 如 果 我 们 自己 的 类 型 也 实现 了 这 些 接口 ， 就 可 以 立刻 支持 








己 有 的 大 量 功能 
8.4.4 ”结论 


可 以 在 io 包 里 找到 大 量 的 文 持 不 同 功能 的 函数 ， 这 些 函 数 都 能 
过 实现 了 io.Writer 和 io.Reader 接口 类 型 的 值 进行 调用 。 ee 
如 http 包 ， 也 使 用 类 似 的 模式 ， 将 接口 声明 为 包 的 API 的 一 部 分 ， 并 提 
供 对 io 包 的 支持 。 应 该 花 时 间 看 一 下 标准 库 中 提供 了 些 什 么 ， 以 及 它 
是 如 何 实 志 D 不 仅 要 防止 重新 造 轮子 ， 还 要 要 理解 Go 语言 百 的 设计 者 
的 习惯 ， 并 将 这 些 习 惯 应 用 到 自己 的 包 和 API 的 设计 上 。 








8.5 ”小 结 


。 标准 库 有 特殊 的 保证 ， 并 且 被 社区 广泛 应 用 。 
。 使 用 标准 库 的 包 会 让 你 的 代码 更 易于 管理 ， 别 人 也 会 更 信任 你 的 代 


。 100 余 个 包 被 合理 组 织 ， 分 布 在 38 个 类 别 里 。 

。 标准 库 里 的 log 包 拥 有 记录 日 志 所 需 的 一 切 功 能 

。 标准 库 里 的 xml 和 json 包 让 处 理 这 两 种 数据 格式 变 得 4 民 简 单 。 
。 io 包 文 持 以 流 的 方式 高 效 处 理 数据 。 

。 接口 允许 你 的 代码 组 合 已 有 的 功能 。 

。 阅读 标准 库 的 代码 是 熟悉 Go 语言 习惯 的 好 方法 。 

















往生 


第 9 草 ”测试 和 性 能 
本 章 主要 内 容 


。 编写 单元 测试 来 验证 代码 的 正确 性 

。 使 用 httptest 来 模拟 基于 HTTP 的 请 求 和 啊 应 
。 使 用 示例 代码 来 给 包 写 文档 

。 通过 基准 测试 来 检查 性 能 


作为 一 名 合格 的 开发 者 ， 不 应 该 在 程序 开发 完 之 后 才 开 始 写 测试 代 
码 。 使 用 Go 语言 的 测试 框架 ， 可 以 在 开发 的 过 程 中 就 进行 单元 测试 和 
基准 测试 。 和 go build 命令 类 似 ，go test 命令 可 以 用 来 执行 写 好 的 
测试 代码 ， 需 要 做 的 就 是 遵守 一 些 规则 来 写 测试 。 而 且 ， 可 以 将 测试 无 
颖 地 集成 到 代码 工程 和 持续 集成 系统 里 。 


9.1 单元 测试 


单元 测试 是 用 来 测试 包 或 者 程序 的 一 部 分 代码 或 者 一 组 代码 的 函 
数 。 测 试 的 目的 是 确认 目标 代码 在 给 定 的 场景 下 ， 有 没有 按照 期 望 工 
作 。 一 个 场景 是 正 同 路 经 测试 ， 惑 是 在 正常 执行 的 情况 下 ， 保 证 代码 不 
产生 错误 的 测试 。 这 种 测试 可 以 用 来 确认 代码 可 以 成 功 地 回 数 据 库 中 插 
入 一 条 工作 记录 。 


为 外 一 些 单元 测试 可 能 会 测试 负 回 路 径 的 场景 ， 保 证 代码 不 仅 会 产 
生 错 误 ， 而 且 是 预期 的 错误 。 这 种 场景 下 的 测试 可 能 是 对 数据 库 进 行 碍 
询 时 没有 找到 任何 结果 ， 或 者 对 数据 库 做 了 无 效 的 更 新 。 在 这 两 种 情况 
下 ， 测 试 都 要 验证 确实 产生 了 错误 ， 且 产生 的 是 预期 的 错误 。 总 之 ， 不 
党 如 何 调用 或 者 执行 代码 ， 所 写 的 代码 行为 都 是 可 预期 的 。 


在 Go 语言 里 有 几 种 方法 写 单元 测试 。 基 础 测试 (basic test) 只 使 
用 一 组 参数 和 结果 来 测试 一 段 代 码 。 表 组 测试 〈table test) 也 会 测试 一 
段 代 码 ， 但 是 会 使 用 多 组 参数 和 结果 进行 测试 。 也 可 以 使 用 一 些 方法 来 
模仿 〈mock) 测试 代码 需要 使 用 到 的 外 部 资源 ， 如 数据 库 或 者 网 络 服 
务 器 。 这 有 助 于 让 测试 在 没有 所 需 的 外 部 资源 可 用 的 时 候 ， 模 拟 这 些 资 
源 的 行为 使 测试 正常 进行 。 最 后 ， 在 构建 自己 的 网 络 服务 时 ， 有 有 几 种 方 




















法 可 以 在 不 运行 服务 的 情况 下 ， 调 用 服务 的 功能 进行 测试 。 
9.1.1 基础 单元 测试 


让 我 们 看 一 个 单元 测试 的 例子 ， 如 代码 清单 9-1 所 示 。 


代码 清单 9-1 listing01_test.go 

















// 这 个 示例 程序 展示 如 何 写 基 础 单元 测试 
package listinge1 





import ( 
"net/http" 
"testing" 
) 


const checkMark = "\Uu2713" 
const ballotX = "Nu2717"” 


// TestDownload 确 认 http 包 的 Get 函 数 可 以 下 载 内 容 
func TestDownload(t *testing.T) { 
url := "http://www.goinggo.net/feeds/posts/default?alt=rss 


statusCode := 200 


t.Log("Given the need to test downloading content.") 
{ 
t.Logf("\tWhen checking \"%s\" for status code \"%d\"", 
url, statusCode) 
{ 
resp, err := http.Get(url) 
if err != nil { 


t.Fatal("\t\tShould be able to make the Get call.", 
ballotX, err) 
} 
t.Log("\t\tShould be able to make the Get call.", 


checkMark) 
defer resp.Body.Close() 


if resp.StatusCode == statusCode { 
t.Logf("\t\tShould receive a \"%d\" status. %v", 
statusCode, checkMark) 
} else { 
t.Errorf("\t\tShould receive a \"%d\" status. %v %v", 


37 statusCode, ballotX, resp.StatusCode) 





代码 清单 9-1 展 示 了 测试 http 包 的 Get 函数 的 单元 测试 。 测 试 的 内 
容 是 确保 可 以 从 网 络 正 常 下 载 goinggo.net 的 RSS 列 表 。 如 果 通 过 调用 go 
test -Vv 来 运行 这 个 测试 (-v 表示 提供 元 余 输出 ) ， 会 得 到 图 9-1 所 示 
的 测试 结果 。 


$ go test -V 
=== RUN TestDownload 
--- PASS: TestDownload (0.43s) 
listing0l1_test.go:17: Given the need to test downloading content. 


listing91_test.go:20: When checking "http://ww.goinggo.net/feeds/posts 
Listing91_test.go:28; Should be able to make the Get call.v 
Listing91_test.go:34: Should receive a "280" status. v 
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图 9-1 基础 单元 测试 的 输出 


这 个 例子 背后 发 生 了 很 多 事情 ， 来 确保 测试 能 正确 工作 ， 并 显示 结 
果 。 让 我 们 从 测试 文件 的 文件 名 开始 。 如 果 查 看 代码 清单 9-1 一 开始 的 
部 分 ， 会 看 到 测试 文件 的 文件 名 是 listing01_test.go。Go 语 言 的 测试 工具 
只 会 认为 以 test.go 结 尾 的 文件 是 测试 文件 。 如 果 没 有 遵从 这 个 约定 ， 在 
包 里 运行 go test 的 时 候 就 可 能 会 报告 没有 测试 文件 。 一 旦 测试 工具 找 
到 了 测试 文件 ， 就 会 查找 里 面 的 测试 函数 并 执行 。 


二 我 们 全 细 罕 I0 Bestgp 遇 斌 六 件 时 而 的 人 QI9: 杂 代 得 清 半 
9-2 及 不 。 

















代码 清单 9-2 ”listing01_test.go: 第 01 行 到 第 10 行 

















81 // 这 个 示例 程序 展示 如 何 写 基础 单元 测试 
62 package listinge1 





03 
64 import ( 
65 "net/http" 


66 "testing" 


69 const checkMark = "\u2713" 
16 const ballotX = "Nu2717"” 





在 代码 清单 9-2 里 ， 可 以 看 到 第 06 行 引入 了 testing 包 。 这 
个 testing 包 提 供 了 从 测试 框架 到 报告 测试 的 输出 和 状态 的 各 种 测试 功 
能 的 文 持 。 第 09 行 和 第 10 行 声明 了 两 个 常量 ， 这 两 个 第 量 包含 写 测 试 输 
出 时 会 用 到 的 对 号 (V) 和 又 号 〈x) 。 


接 下 来 ， 让 我 们 看 一 下 测试 函数 的 声明 ， 如 代码 清单 9-3 所 示 。 


代码 清单 9-3 ”listing01_test.go: 第 12 行 到 第 13 行 














12 // TestDownload 确 认 http 包 的 Get 函 数 可 以 下 载 内 容 


13 func TestDownload(t *testing.T) { 





在 代码 清单 9-3 的 第 13 行 中 ， 可 以 看 到 测试 函数 的 名 字 
是 TestDownload 。 一 个 测试 函数 必须 是 公开 的 函数 ， 并 且 以 Test 单 
词 开 头 。 不 但 函数 名 字 要 以 Test 开头 ， 而 且 函 数 的 签名 必须 接收 一 个 
指向 testing.T 类 型 的 指针 ， 并 且 不 返回 任何 值 。 如 果 没 有 遵守 这 些 约 
定 ， 测 试 框架 就 不 会 认为 这 个 函数 是 一 个 测试 函数 ， 也 不 会 让 测试 工具 
去 执行 它 。 


指向 testing.T 类 型 的 指针 很 重要 。 这 个 指针 提供 的 机 制 可 以 报告 
每 个 测试 的 输出 和 状态 。 测 试 的 输出 格式 没有 标准 要 求 。 我 更 喜欢 使 用 
Go 写 文档 的 方式 ， 输 出 容易 读 的 测试 结果 。 对 我 来 说 ， 测 试 的 输出 是 
代码 文档 的 一 部 分 。 测 试 的 输出 需 使 用 完整 易 读 的 语句 ， 来 记录 为 什么 
需要 这 个 测试 ， 具 体 测试 了 什么 ， 以 及 测试 的 结果 是 什么 。 让 我 们 来 看 
一 下 更 多 的 代码 ， 了 解 我 是 如 何 完成 这 些 测试 的 ， 如 代码 清单 9-4 所 
外。 




















代码 清单 9-4 ”listing01_test.go: 第 14 行 到 第 18 行 





14 url := "http://www.goinggo.net/feeds/posts/default?alt=rss 


15 statusCode := 200 


17 t.Log("Given the need to test downloading content.") 
18 { 





可 以 看 到 ， 在 代码 清单 9-4 的 第 14 行 和 第 15 行 ， 声 明 并 初始 化 了 两 
个 变量 。 这 两 个 变量 包含 了 要 测试 的 URL， 以 及 期 望 从 啊 应 中 返回 的 状 
态 。 在 第 17 行 ， 使 用 方法 t.Log 来 输出 测试 的 消息 。 这 个 方法 还 有 一 个 
名 为 t.Logf 的 版 本 ， 可 以 格式 化 消 轧 。 如 果 执 行 go test 的 时 候 没有 
Oe 


每 个 训 试 函数 都 应 该 通过 解释 这 个 测试 的 给 定 要 求 (given 
need) ， 来 说 明 为 什么 应 该 存在 这 个 测试 。 对 这 个 例子 来 说 ， 给 定 要 求 
古 测试 能 合成 功 下 载 数 据 。 在 声明 了 测试 的 给 定 要 求 后 ， 测 试 应 该 说 明 
被 测试 的 代码 应 该 在 什么 情况 下 被 执行 ， 以 及 如 何 执行 。 


代码 清单 9-5 ”listing01_test.go: 第 19 行 到 第 21 行 











t.Logf("\tWhen checking \"%s\" for status code \"%d\"", 
url, statusCode) 





可 以 在 代码 清单 9-5 的 第 19 行 看 到 测试 执行 条 件 的 说 明 。 它 特别 说 
明了 要 测试 的 值 。 接 下 来 ， 让 我 们 看 一 下 被 测试 的 代码 是 如 何 使 用 这 些 
值 来 进行 测试 的 。 








代码 清单 9-6 ”listing01_test.go: 第 22 行 到 第 30 行 





resp, err := http.Get(url) 
if err != nil { 
t.Fatal("\t\tShould be able to make the Get call.", 
ballotX, err) 


} 
t.Log("\t\tShould be able to make the Get call.", 
checkMark) 


defer resp.Body.Close() 





代码 清单 9-6 中 的 代码 使 用 http 包 的 Get 函数 来 向 goinggo.net 网 络 
服务 器 发 起 请 求 ， 请 求 下 载 该 博客 的 RSS 列 表 。 在 Get 调用 返回 之 后 ， 
会 检查 错误 值 ， 来 判断 调用 是 否 成 功 。 在 每 种 情况 下 ， 我 们 都 会 说 明 测 
试 应 有 的 结果 。 如 果 调 用 失败 ， 除 了 结果 ， 还 会 输出 又 号 以 及 得 到 的 错 
误 值 。 如 果 测 试 成 功 ， 会 输出 对 号 。 


如 果 Get 调用 失败 ， 使 用 第 24 行 的 t.Fatal 方法 ， 让 测试 框架 知道 
这 个 测试 失败 了 。t.Fatal 方法 不 但 报告 这 个 单元 测试 已 经 失败 ， 而 且 
会 向 测试 输出 写 一 些 消 息 ， 而 后 立刻 停止 这 个 测试 函数 的 执行 。 如 果 除 
了 这 个 函数 外 还 有 其 他 没有 执行 的 测试 函数 ， 会 继续 执行 其 他 测试 函 
数 。 这 个 方法 对 应 的 格式 化 版 本 名 为 t.Fatalf 。 


如 果 需 要 报告 测试 失败 ， 但 是 并 不 想 停止 当前 测试 函数 的 执行 ， 可 
以 使 用 t.Error 系列 方法 ， 如 代码 清单 9-7 所 示 。 


代码 清单 9-7 listing01_test.go: 第 32 行 到 第 41 行 














if resp.StatusCode == statusCode { 
t.Logf("\t\tShould receive a \"%d\" status. %v", 
statusCode, checkMark) 
} else { 
t.Errorf("\t\tShould receive a \"%d\" status. %v %v", 


statusCode, ballotX, resp.StatusCode) 





在 代码 清单 9-7 的 第 32 行 ， 会 将 啊 应 返回 的 状态 码 和 我 们 期 望 收 到 
的 状态 码 进 行 比较 。 我 们 再 次 声明 了 期 望 测试 返回 的 结果 是 什么 。 如 果 
状态 码 匹配 ， 我 们 就 使 用 t.Logf 方法 输出 信息 ; 否则， 就 使 
用 t.Errorf 方法 。 因 为 t.Errorf 方法 不 会 停止 当前 测试 函数 的 执 
行 ， 所 以 ， 如 果 在 第 38 行 之 后 还 有 测试 ， 单 元 测试 就 会 继续 执行 。 如 果 
AR .Fatal 或 者 t.Error 方法 ， 就 会 认为 测试 
通过 了 。 


如 果 再 看 一 下 测试 的 输出 《如 图 9-2 所 示 ) ， 你 会 看 到 这 段 代 码 组 
合 在 一 起 的 效果 。 


$ go test -Vv 

=== RUN TestDownload 

--— PASS: TestDownload (0.43s) 
listingO1_test.go:17: Given the need to test downloading content. 
listing0l1_test.go:20: When checking "http://ww.goinggo.net/feeds/posts 
listing01_test.go:28: Should be able to make the Get call.v 
listing0l1_test.go:34: Should receive a "200" status. v 
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图 9-2 ”基础 单元 测试 的 输出 


在 图 9-2 中 能 看 到 这 个 测试 的 完整 文档 。 下 载 给 定 的 内 容 ， 当 检测 
获取 URL 的 内 容 返 回 的 状态 码 时 在 图 中 被 截断 ) ， 我 们 应 该 能 够 成 功 
完成 这 个 调用 并 收 到 状态 200。 测 试 的 输出 很 清晰 ， 能 描述 测试 的 日 
的 ， 同 时 包含 了 足够 的 信息 。 我 们 知道 具体 是 哪个 单元 测试 被 运行 ， 测 
试 通过 了 ， 并 且 运 行 消耗 的 时 间 是 435 室 秒 。 


9.1.2” 表 组 测试 


如 果 测 试 可 以 接受 一 组 不 同 的 输入 并 产生 不 同 的 输出 的 代码 ， 那 么 
应 该 使 用 表 组 测试 的 方法 进行 测试 。 表 组 测试 除了 会 有 一 组 不 同 的 输 
入 值 和 期 望 结 采 之 外 ， 其 余部 分 都 很 像 基础 单元 测试 。 测 试 会 依次 迭代 
不 同 的 值 ， 来 运行 要 测试 的 代码 。 每 次 过 代 的 时 候 ， 都 会 检测 返回 的 结 
果 。 这 便于 在 一 个 函数 里 测试 不 同 的 输入 值 和 条 件 。 让 我 们 看 一 个 表 组 
测试 的 例子 ， 如 代码 清单 9-8 所 示 。 











代码 清单 9-8 listing08_test.go 




















81 // 这 个 示例 程序 展示 如 何 写 一 个 基本 的 表 组 测试 








62 package 1Listing68 


03 

64 import ( 

05 "net/http" 
66 "testing" 
67 ) 

08 


69 const checkMark = "\u2713" 
16 const ballotX = "Nu2717"” 





12 // TestDownload 确 认 http 包 的 Get 函 数 可 以 下 载 内 容 
13 // 并 正确 处 理 不 同 的 状态 
14 func TestDownload(t *testing.T) { 























15 var urls = []jstruct { 


16 url string 

17 statusCode int 

18 上 

19 { 

20 "http://www.goinggo.net/feeds/posts/default?alt=rss 
21 http .StatusOK， 

22 }， 

23 { 

24 "http://rss.cnn.com/rss/cnn topstbadurl.rss 

25 http.StatusNotFound, 

26 }， 

27 } 

28 

29 t.Log("Given the need to test downloading different content.") 
36 { 

31 for ，U := range Urls { 

32 t.Logf("\tWhen checking \"%s\" for status code \"%d\"", 
33 u.url, u.statusCode) 

34 { 

35 resp, err := http.Get(u.url) 

36 if err != nil { 

37 t.Fatal("\t\tShould be able to Get the url.", 
38 ballotX, err) 

39 } 

46 t.Log("\t\tShould be able to Get the url", 

41 checkMark) 

42 

43 defer resp.Body.Close() 

44 

45 if resp.StatusCode == U.SstatusCode { 

46 t.Logf("\t\tShould have a \"%d\" status. %v", 
47 u.statusCode, checkMark) 

48 } else { 

49 t.Errorf("\t\tShould have a \"%d\" status %v %v", 
56 u.statusCode, ballotX, resp.StatusCode) 
51 } 

52 } 

53 } 

54 } 





在 代码 清单 9-8 中 ， 我 们 稍微 改动 了 之 前 的 基础 单元 测试 ， 将 其 变 
为 表 组 测试 。 现 在 ， 可 以 使 用 一 个 测试 函数 来 测试 不 同 的 URL 以 及 
http .Get 方法 的 返回 状态 码 。 我 们 不 需要 为 每 个 要 测试 的 URL 和 状态 
码 创 建 一 个 新 测试 函数 。 让 我 们 看 一 下 ， 和 之 前 相 比 ， 做 了 哪些 改动 ， 
如 代码 清单 9-9 所 示 。 








代码 清单 9-9 listing08_test.go: 第 12 行 到 第 27 行 





12 // TestDownload 确 认 http 包 的 Get 函 数 可 以 下 载 内容 
13 // 并 正确 处 理 不 同 的 状态 
14 func TestDownload(t *testing.T) { 
var urls = []jstruct { 
url string 
statusCode int 
}{ 
{ 




















"http://www.goinggo.net/feeds/posts/default?alt=rss 


http .StatusOK， 


}, 
{ 


"http://rss.cnn.com/rss/cnn topstbadurl.rss 


http.StatusNotFound, 
)， 





在 代码 清单 9-9 中 ， 可 以 看 到 和 之 前 同名 的 测试 函数 TestDownload 
， 它 接收 一 个 指向 testing.T 类 型 的 指针 。 但 这 个 版 本 的 
TestDownload 略微 有 些 不 同 。 在 第 15 行 到 第 27 行 ， 可 以 看 到 表 组 的 实 
现代 码 。 表 组 的 第 一 个 字段 是 URL， 指 向 一 个 给 定 的 互联 网 资源 ， 第 二 
个 字段 是 我 们 请 求 资 源 后 期 望 收 到 的 状态 码 。 


目前 ， 我 们 的 表 组 只 配置 了 两 组 值 。 第 一 组 值 是 goinggo.net 的 
URL， 啊 应 状态 为 OK， 第 二 组 值 是 男 一 个 URL， 啊 应 状态 为 
NotFound。 运 行 这 个 测试 会 得 到 图 9-3 所 示 的 输出 。 





$ go test -v 

=== RUN TestDownload 

--- PASS: TestDownload .72S) 
Listing92_test.go;29: Given the need to test downloading different conten 
listing02_test.go:33: When checking "http://ww.goinggo.net/feeds/posts 
listing02_test.go:41: Should be able to Get the url. v 


listing02_test.go:47: Should have a "200" status. v 
listing02_test. go:33: When checking "http://rss.cnn.com/rss/cnn_topstbad 
listing02_test.go:41: Should be able to Get the url.v 
listing02_ test.go:47: Should have a "404" status. v 





github .com/goinaction/code/chapter9/Listing92 09.724s 
图 9-3” 表 组 测试 的 输出 
图 9-3 所 示 的 输出 展示 了 如 何 达 代表 组 里 的 值 ， 并 使 用 其 进行 测 
试 。 输 出 看 起 来 和 基础 单元 测试 的 输出 很 像 ， 只 是 每 次 都 会 输出 两 个 不 
同 的 URL 及 其 结果 。 测 试 又 通过 了 。 


让 我 们 看 一 下 我 们 是 如 何 让 表 组 测试 工作 的 ， 如 代码 清单 9-10 所 


中 


I 





AAA 


单 9-10 ”listing08_test.go: 第 29 行 到 第 34 行 














代码 削 











t.Log("Given the need to test downloading different content.") 
{ 


for , uu := range urls { 
t.Logf("\tWhen checking \"%s\" for status code \"%d\"", 
u.url, u.statusCode) 


{ 





代码 清单 9-10 的 第 31 行 的 for range 循环 让 测试 迭代 表 组 里 的 值 ， 
使 用 不 同 的 URL 运 行 测试 代码 。 测 试 的 代码 与 基础 单元 测试 的 代码 相 
同 ， 只 不 过 这 次 使 用 的 是 表 组 内 的 值 进行 测试 ， 如 代码 清单 9-11 所 示 。 


代码 清单 9-11 ”listing08_test.go: 第 35 行 到 第 55 行 




















35 resp, err := http.Get(u.url) 

36 if err != nil { 

37 t.Fatal("\t\tShould be able to Get the url.", 
38 ballotX, err) 


46 t.Log("\t\tShould be able to Get the url", 


41 checkMark) 

42 

43 defer resp.Body.Close() 

44 

45 if resp.StatusCode == U.SstatusCode { 

46 t.Logf("\t\tShould have a \"%d\" status. %v", 
47 u.statusCode, checkMark) 

48 } else { 

49 t.Errorf("\t\tShould have a \"%d\" status %v %v", 
50 u.statusCode, ballotX, resp.StatusCode) 
51 } 

52 } 

53 } 

54 

55 } 








代码 清单 9-11 的 第 35 行 中 展示 了 代码 如 何 使 用 u.url 字段 来 做 URL 
调用 。 在 第 45 行 中 ，u.statusCode 字段 被 用 于 和 实际 的 响应 状态 码 
进行 比较 。 如 果 以 后 需要 扩展 测试 ， 只 需要 将 新 的 URL 和 状态 码 加 入 表 
组 就 可 以 ， 不 需要 改动 测试 的 核心 代码 。 


9.1.3 ”模仿 调用 
我 们 之 前 写 的 单元 测试 都 很 好 ， 但 是 还 有 些 瑕 疫 。 首 先 ， 这 些 测试 


才能 保证 测试 运行 成 功 。 图 9-4 展 示 了 如 果 没 有 互联 
网 连接 ， 运 行 基础 单元 测试 会 测试 失败 。 














$ go test -Vv 

=== RUN TestDownLoad 

--—— FAIL: TestDownload (0.606s) 
listing01_test.go:17: Given the need to test downloading content. 
listing01_test.go:20: When checking "http://ww.goinggo.net/feeds/posts 
listingO1_test.go:25: Should be able to make the Get call. xX Get 


http://ww.goinggo.net/feeds/posts/default?alt=rss: dial tcp: lookup www.goinggo. 
net: no such host 
FAIL 
exit status 1 
FAIL github.com/goinaction/code/chapter9/listing91 9.999s 























图 9-4 ”由 于 没有 互联 网 连接 导致 测试 失败 
不 能 总 是 假设 运行 测试 的 机 器 可 以 访问 互联 网 。 此 外 ， 依 赖 不 属于 





你 的 或 者 你 无 法 操作 的 服务 来 进行 测试 ， 也 不 是 一 个 好 习惯 。 这 两 点 会 
严重 影响 测试 持续 集成 和 部 车 的 目 动 化 。 如 果 突 然 断 网 ， 导 致 测试 失 
败 ， 就 没 办 法 部 车 新 构建 的 程序 。 


为 了 修正 这 个 问题 ， 标 准 库 包含 一 个 名 为 httptest 的 包 ， 它 让 开 
发 人 员 可 以 模仿 基于 HTTP 的 网 络 调 有 用。 模仿 (mocking〉 是 一 个 很 常用 
的 技术 手段 ， 用 来 在 运行 测试 时 模拟 访问 不 可 用 的 资源 。 包 httptest 
可 以 让 你 能 够 模仿 互联 网 资源 的 请 求 和 啊 应 。 在 我 们 的 单元 测试 中 ， 通 
过 模仿 http.Get 的 啊 应 ， 我 们 可 以 解决 在 图 9-4 中 过 到 的 问题 ， 保 证 在 
没有 网 络 的 时 候 ， 我 们 的 测试 也 不 会 失败 ， 依 旧 可 以 验证 我 们 的 
http .Get 调用 正常 工作 ， 并 且 可 以 处 理 预 期 的 啊 应 。 让 我 们 看 一 下 基 
础 单元 测试 ， 并 将 其 改 为 模仿 调用 goinggo.net 网 站 的 RSS 列 表 ， 如 代码 
清单 9-12 所 示 。 








I 
lm 





代码 清单 9-12 ”listing12_test.go: 第 01 行 到 第 41 行 














861 // 这 个 示例 程序 展示 如 何 内 部 模仿 HTTP GET 调 用 
82 // 与 本 书 之 前 的 例子 有 些 差别 
63 package listing12 








04 

65 import ( 

66 "encoding/xml" 

07 "fmt" 

068 "net/http" 

069 "net/http/httptest" 
16 "testing" 

11 ) 

12 


13 const checkMark = "\Uu2713" 
14 const ballotX = "Nu2717"” 





15 

16 // feed 模仿 了 我 们 期 望 接收 的 XML 文档 

17 var feed = <?xml version="1.60" encoding="UTF-8"?> 

18 <rss> 

19 <channel> 

20 <title>Going Go Programming</title> 

21 <description>Golang : https://github.com/goinggo</description> 
22 <link>http://www.goinggo.net/</link> 

23 <item> 


24 <pubDate>Sun, 15 Mar 2615 15:04:66 +06666</pubDatey> 


25 <title>Object Oriented Programming Mechanics</title> 


26 <description>Go is an object oriented language.</description> 
27 <Link>http://www.goinggo.net/2615/63/object-oriented</1Linky> 
28 </item> 

29 </channel> 

36 </rss> 

31 





32 // mockServer 返 回 用 来 处 理 请 求 的 服务 器 的 指针 
33 func mockServer() *httptest.Server { 

















34 f := func(w http.ResponseWriter, r *http.Request) { 
35 w.WriteHeader(260) 

36 w.Header().Set("Content-Type", "application/xml") 
37 fmt.Fprintln(w, feed) 

38 } 

39 

40 return httptest.NewServer(http .HandlerFunc(f) ) 

41 } 





代码 清单 9-12 展 示 了 如 何 模仿 对 goinggo.net 网 站 的 调用 ， 来 模拟 下 
载 RSS 列 表 。 在 第 17 行 中 ， 声 明了 包 级 变量 feed ， 并 初始 化 为 模仿 服 
务 器 返回 的 RSS XML 文档 的 字符 串 。 这 是 实际 RSS 文 档 的 一 小 段 ， 足 以 
完成 我 们 的 测试 。 在 第 33 行 中 ， 我 们 声明 了 一 个 名 为 mockServer 的 函 
数 ， 这 个 函数 利用 httptest 包 内 的 支持 来 模拟 对 互联 网 上 真实 服务 器 
的 调用 ， 如 代码 清单 9-13 所 示 。 























代码 清单 9-13 listing12_test.go: 第 32 行 到 第 41 行 


























32 // mockSserver 返 回 用 来 处 理 调 用 的 服务 器 的 指针 
33 func mockServer() *httptest.Server { 
f := func(w http.ResponseWriter, r *http.Request) { 
w.WriteHeader(208608) 
w.Header().Set("Content-Type", "application/xml") 
fmt.Fprintln(w, feed) 
} 


return httptest.NewServer(http.HandlerFunc(f)) 





代码 清单 9-13 中 声明 的 mockServer 函数 ， 返 回 一 个 指 


向 httptest .Server 类 型 的 指针 。 这 个 httptest.Server 的 值 是 整个 
模仿 服务 的 关键 。 函 数 的 代码 一 开始 声明 了 一 个 匿名 函数 ， 其 签名 符 
合 http.HandlerFunc 函数 类 型 ， 如 代码 清单 9-14 所 示 。 


代码 清单 9-14 golang.org/pkg/net/http/#HandlerFunc 























type HandlerFunc func(ResponseWriter, *Request) 






































HandlerFunc 类 型 是 一 个 适配器 ， 人 允许 常规 函数 作为 HTTP 的 处 理 函 数 使 用 。 如 果 函 数 f 








适 的 签名 ， 
HandlerFunc(f) 就 是 一 个 处 理 HTTP 请 求 的 Handler 对 象 ， 内 部 通过 调用 f 处 理 















































遵守 这 个 签名 ， 让 匿名 函数 成 了 处 理 函 数 。 一 旦 声明 了 这 个 处 理 冰 
数 ， 第 40 行 就 会 使 用 这 个 匿名 函数 作为 参数 来 调 
用 httptest.NewServer 函数 ， 创 建 我 们 的 模仿 服务 器 。 之 后 在 第 40 
行 ， 通 过 指针 返回 这 个 模仿 服务 器 。 


我 们 可 以 通过 http .Get 调用 来 使 用 这 个 模仿 服务 器 ， 用 来 模拟 对 
goinggo.net 网 络 服务 器 的 请 求 。 当 进行 http .Get 调用 时 ， 实 际 执行 的 
是 处 理 函 数 ， 并 用 处 理 函 数 模 仿 对 网 络 服务 器 的 请 求 和 啊 应 。 在 第 35 
行 ， 处 理 函 数 首先 设置 状态 人 码 ， 之 后 在 第 36 行 ， 设 置 返回 内 容 的 类 型 
Content-Type ， 最 后 ， 在 第 37 行 ， 使 用 包含 XML 内 容 的 字符 串 feed 
作为 响应 数据 ， 返 回 给 调用 者 。 


现在 ， 让 我 们 看 一 下 模仿 服务 占 与 基础 单元 测试 是 怎么 整合 在 一 起 
的 ， 以 及 如 何 将 http.Get 请 求 及 送 到 模仿 服务 硕 ， 如 代码 清单 9-15 所 
示 。 
































代码 清单 9-15 ”listing12_test.go: 第 43 行 到 第 74 行 








43 // TestDownload 确 认 http 包 的 Get 函 数 可 以 下 载 内 容 








44 // 并 且 内 容 可 以 被 正确 地 反 序列 化 并 关闭 
45 func TestDownload(t *testing.T) { 





46 statusCode := http.StatusOK 

47 

48 server := mockServer() 

49 defer server.Close() 

56 

51 t.Log("Given the need to test downloading content.") 
52 


53 t.Logf("\tWhen checking \"%s\" for status code \"%d\"", 


54 server.URL, statusCode) 


55 { 

56 resp, err := http.Get(server.URL) 

57 if err != nil { 

58 t.Fatal("\t\tShould be able to make the Get call.", 
59 ballotX, err) 

60 } 

61 t.Log("\t\tShould be able to make the Get call.", 

62 checkMark) 

63 

64 defer resp.Body.Close() 

65 

66 if resp.StatusCode != statusCode { 

67 t.Fatalf("\t\tShould receive a \"%d\" status. %v %v", 
68 statusCode, ballotX, resp.StatusCode) 

69 } 

70 t.Logf("\t\tShould receive a \"%d\" status. %v", 

71 statusCode, checkMark) 

72 } 

73 

74 } 





在 代码 清单 9-15 中 再 次 看 到 了 TestDownload 函数 ， 不 过 这 次 它 在 
请 求 模 仿 服 务 器 。 在 第 48 行 和 第 49 行 ， 调 用 mockServer 函数 生成 模仿 
服务 器 ， 并 安排 在 测试 函数 返回 时 执行 服务 器 的 Close 方法 。 之 后 ， 除 
了 代码 清单 9-16 所 示 的 这 一 行 代码 ， 这 段 测试 代码 看 上 去 和 基础 单元 测 
试 的 代码 一 模 一 样 。 


代码 清单 9-16 listing12_test.go: 第 56 行 





56 resp, err := http.Get(server.URL) 


这 次 由 httptest.Server 值 提供 了 请 求 的 URL。 当 我 们 使 用 由 模 
仿 服务 器 提供 的 URL 时 ，http.Get 调用 依旧 会 按 我 们 预期 的 方式 运 
行 。http .Get 方法 调用 时 并 不 知道 我 们 的 调用 是 否 经 过 互联 网 。 这 次 
调用 最 终 会 执行 ， 并 且 我 们 自己 的 处 理 函 数 最 终 被 执行 ， 返 回 我 们 预先 
准备 好 的 XML 文 档 和 状态 码 http.StatusOK 。 


在 图 9-5 里 ， 如 果 在 没有 互联 网 连接 的 时 候 运 行 测试 ， 可 以 看 到 测 
试 依旧 可 以 运行 并 通过 。 这 张 图 展示 了 程序 是 如 何 再 次 通过 测试 的 。 如 
果 仔 细 看 用 于 调用 的 URL， 会 发 现 这 个 URL 使 用 了 localhost 作为 地 














址 ， 端 口 是 52065。 这 个 端口 号 每 次 运行 测试 时 都 会 改变 。 包 http 与 
包 httptest 和 模仿 服务 器 结合 在 一 起 ， 知 道 如 何 通 过 URL 路 由 到 我 们 
自己 的 处 理 函 数 。 现 在 ， 我 们 可 以 在 没有 触 碰 实 际 服务 器 的 情况 下 ， 测 
试 请 求 goinggo.net 的 RSS 列 表 。 


$ go test -V 

=== RUN TestDownload 

--- PASS: TestDownload (0.00s) 
Listing693_test.go:51: Given the need to test downloading content. 
listinge3_test.go:54: When checking "http://127.0.0.1:52065" for status code "200" 
listing03_test.go:62: Should be able to make the Get call.v 


listing03_test.go:71: Should receive a "200" status. v 
listing03_test.go:79: Should be able to unmarshal the response. v 
listing03_test.go:83: Should have "1" item in the feed. v 


github.com/goinaction/code/chapter9/listing03 0.007s 





图 9-5 没有 互联 网 接 入 情况 下 测试 成 功 
9.1.4 测试 服务 端点 


服务 端点 (endpoint) 是 指 与 服务 宿主 信息 无 关 ， 用 来 分 辨 某 个 服 
务 的 地 址 ， 一 般 是 不 包含 宿主 的 一 个 路 径 。 如 果 在 构造 网 络 API， 你 会 
希望 直接 测试 上 自己 的 服务 的 所 有 服务 端点 ， 而 不 用 局 动 整 个 网 络 服务 。 
包 httptest 正好 提供 了 做 到 这 一 点 的 机 制 。 让 我 们 看 一 个 简单 的 包含 
一 个 服务 端点 的 网 络 服务 的 例子 ， 如 代码 清单 9-17 所 示 ， 之 后 你 会 看 到 
如 何 写 一 个 单元 测试 ， 来 模仿 真正 的 调用 。 











代码 清单 9-17 listing17.go 











81 // 这 个 示例 程序 实现 了 简单 的 网 络 服 务 
62 package main 





63 

64 import ( 

65 "log" 

66 "net/http" 

67 

68 "github.com/goinaction/code/chapter9/listing17/handlers" 
69 ) 

16 





11 // main 是 应 用 程序 的 入 口 
12 func main() { 
13 handlers .Routes() 





15 log.Println("listener : Started : Listening on :4666") 
16 http .ListenAndSserve(":46606"，nil) 
17 } 





代码 清单 9-17 展 示 的 代码 文件 是 整个 网 络 服务 的 入 口 。 在 第 13 行 的 
main 函数 里 ， 代 码 调 用 了 内 部 handlers 包 的 Routes 函数 。 这 个 函数 
为 托管 的 网 络 服务 设置 了 一 个 服务 端点 。 在 main 函数 的 第 15 行 和 第 16 
行 ， 显 示 服 务 监听 的 端口 ， 并 且 启 动 网 络 服务 ， 等 待 请 求 。 


现在 让 我 们 来 看 一 下 handlers 包 的 代码 ， 如 代码 清单 9-18 所 示 。 





代码 清单 9-18 handlers /handlers.go 





























// handlers 包 提供 了 用 于 网 络 服务 的 服务 端点 


package handlers 





import ( 
"encoding/json" 
"net/http" 

) 


// Routes 为 网 络 服 务 设置 路 1 
func Routes() { 
http.HandleFunc("/sendjson", SendJSON) 

















} 




















// SendJSON 返 回 一 个 简单 的 JSON 文 档 





func SendJSON(rw http.ResponseWriter, r *http.Request) { 
U := struct { 
Name string 
Email string 


上 
Name: "Bill", 
Email: "bill@ardanstudios.com", 


} 


rw.Header().Set("Content-Type", "application/json") 
rw.WriteHeader(2060) 


json.NewEncoder (rw) .Encode(&u) 








代码 清单 9-18 里 展示 了 handlers 包 的 代码 。 这 个 包 提 供 了 实现 好 


的 处 理 函 数 ， 并 且 能 为 网 络 服务 设置 路 由 。 在 第 10 行 ， 你 能 看 

到 Routes 函数 ， 使 用 http 包 里 默认 的 http.ServeMux 来 配置 路 由 ， 

将 URL 了 映射 到 对 应 的 处 理 代码 。 在 第 11 行 ， 我 们 将 /sendjson 服务 端点 
与 SendJSON 函数 绑 定 在 一 起 。 


从 第 15 行 起 ， 是 SendJSON 函数 的 实现 。 这 个 函数 的 签名 和 之 前 看 
到 代码 清单 9-14 里 http.HandlerFunc 函数 类 型 的 签名 一 致 。 在 第 16 
行 ， 声 明了 一 个 匿名 结构 类 型 ， 使 用 这 个 结构 创建 了 一 个 名 为 u 的 变 
量 ， 并 赋予 一 组 初 值 。 在 第 24 行 和 第 25 行 ， 设 置 了 响应 的 内 容 类 型 和 状 
最 后 ， 在 第 26 行 ， 将 u 值 编码 为 JSON 文 档 ， 并 发 送 回 发 起 调用 的 
户 端 。 


如 果 我 们 构建 了 一 个 网 络 服务 ， 并 启动 服务 器 ， 就 可 以 像 图 9-6 和 
图 9-7 展 示 的 那样 ， 通 过 服务 获取 JSON 文 档 。 





$ ./listingl17 


2015/06/13 E01 








图 9-6 ”启动 网 络 服务 

€ KK localhost:4000/sendjson 

{"Name":"Bill","Email":"bill@ardanstudios.com"} 
图 9-7 网 络 服务 提 供 的 JSON 文 档 


现在 有 了 包含 一 个 服务 端点 的 可 用 的 网 络 服务 ， 我 们 可 以 写 单 元 测 
试 来 测试 这 个 服务 并 点 ， 如 代码 清单 9-19 所 示 。 


代码 清单 9-19 handlers /handlers_test.go 


























61 // 这 个 示例 程序 展示 如 何 测试 内 部 服务 端点 
62 // 的 执行 效果 
63 package handlers test 








04 

65 import ( 

66 "encoding/json" 

067 "net/http" 

068 "net/http/httptest" 


69 "testing" 


106 
11 
12 
13 


"github.com/goinaction/code/chapter9/listing17/handlers" 


) 


14 const checkMark = "\Uu2713" 
const ballotX = "Nu2717"” 


15 
16 
17 
18 
19 
20 
21 
22 
23 


func init() { 
handlers .Routes() 


} 


// TestsendJSON 测 试 /sendjson 内 部 服务 端点 
func TestSendJSON(t *testing.T) { 
t.Log("Given the need to test the SendJSON endpoint.") 


{ 


req, err := http.NewRequest("GET", "/sendjson", nil) 
if err != nil { 
t.Fatal("\tShould be able to create a request.", 
ballotX, err) 
} 
t.Log("\tShould be able to create a request.", 
checkMark) 


rw := httptest.NewRecorder() 
http.DefaultServeMux.ServeHTTP(rw, req) 


if rw.Code != 260 { 
t.Fatal("\tShould receive \"2686\"", ballotX, rw.Code) 


} 
t.Log("\tShould receive \"2606\"", checkMark) 


U := struct { 
Name string 
Email string 


}{} 


if err := json.NewDecoder(rw.Body).Decode(&u); err != nil { 
t.Fatal("\tShould decode the response.", ballotX) 


} 
t.Log("\tShould decode the response.", checkMark) 


if u.Name == "Bill" { 
t.Log("\tShould have a Name.", checkMark) 
} else { 
t.Error("\tShould have a Name.", ballotX, u.Name) 


} 


if u.Email == "bill@ardanstudios.com" { 


58 t.Log("\tShould have an Email.", checkMark) 
59 } else { 


66 t.Error("\tShould have an Email.", ballotX, u.Email) 





代码 清单 9-19 展 示 了 对 /sendjson 服务 端点 的 单元 测试 。 注 意 ， 第 
03 行 包 的 名 字 和 其 他 测试 代码 的 包 的 名 字 不 太一 样 ， 如 代码 清单 9-20 所 


钞 。 























代码 清单 9-20 handlers /handlers_test.go: 第 01 行 到 第 03 行 











861 // 这 个 示例 程序 展示 如 何 测试 内 部 服务 端点 
62 // 的 执行 效果 








63 package handlers test 








正如 在 代码 清单 9-20 里 看 到 的 ， 这 次 包 的 名 字 也 使 用 _test 结尾 。 
如 果 包 使 用 这 种 方式 命名 ， 测 试 代码 只 能 访问 包 里 公开 的 标识 符 。 即 便 
0 的 代码 帮 在 同一 个 文件 夹 中 ， 也 只 能 访问 公开 的 
未 识 符 。 








就 像 直接 运行 服务 时 一 样 ， 需 要 为 服务 端点 初始 化 路 由 ， 如 代码 清 
单 9-21 所 示 。 














代码 清单 9-21 handlers /handlers_test.go: 第 17 行 到 第 19 行 














17 func init() { 
18 handlers.Routes'() 


19 } 





在 代码 清单 9-21 的 第 17 行 ， 声 明 的 init 函数 里 对 路 由 进行 初始 
化 。 如 果 没 有 在 单元 测试 运行 之 前 初始 化 路 由 ， 那 么 测试 就 会 遇 
到 http.StatusNotFound 错误 而 失败 。 现 在 让 我 们 看 一 下 /sendjson 
服务 端点 的 单元 测试 ， 如 代码 清单 9-22 所 示 。 























代码 清单 9-22 ”handlers /handlers_test.go: 第 21 行 到 第 34 行 





21 // TestSendJSON 测 试 /sendjson 内 部 服务 端点 
22 func TestSendJSON(t *testing.T) { 
t.Log("Given the need to test the SendJSON endpoint.") 


req, err := http.NewRequest("GET", "/sendjson", nil) 
if err != nil { 
t.Fatal("\tShould be able to create a request.", 
ballotX, err) 


t.Log("\tShould be able to create a request.", 
checkMark) 


rw := httptest.NewRecorder() 
http.DefaultServeMux.ServeHTTP(rw, req) 





代码 清单 9-22 展 示 了 测试 函数 TestSsendJSON 的 声明 。 测 试 从 记录 
测试 的 给 定 要 求 开始 ， 然 后 在 第 25 行 创建 了 一 个 http.Request 值 。 这 
个 Request 值 使 用 GET 方法 调用 /sendjson 服务 端点 的 响应 。 由 于 这 个 
调用 使 用 的 是 GET 方法 ， 第 三 个 发 送 数 据 的 参数 被 传 入 nil 。 


之 后 ， 在 第 33 行 ， 调 用 httptest.NewRecoder 子 数 来 创建 一 
个 http.ResponseRecorder 值 。 有 了 http.Request 和 
http.ResponseRecoder 这 两 个 值 ， 束 可 以 在 第 34 行 直接 调用 服务 默 
认 的 多 路 选择 器 (mux) 的 ServeHttp 方法 。 调 用 这 个 方法 模仿 了 外 部 
客户 端 对 /sendjson 服务 端点 的 请 求 。 


一 旦 ServeHTTP 方法 调用 完成 ，http.ResponseRecorder 值 就 包 
含 了 SendJSON 处 理 函 数 的 响应 。 现 在 ， 我 们 可 以 检查 这 个 响应 的 内 
容 ， 如 代码 清单 9-23 所 示 。 


代码 清单 9-23 handlers /handlers_test.go: 第 36 行 到 第 39 行 





























if rw.Code != 260 { 
t.Fatal("\tShould receive \"2606\"", ballotX, rw.Code) 


} 
t.Log("\tShould receive \"2606\"", checkMark) 








首先 ， 在 第 36 行 检查 了 响应 的 状态 。 一 般 任 何 服务 端点 成 功 调用 
后 ， 都 会 期 望 得 到 266 的 状态 码 。 如 果 状 态 码 是 268 ， 之 后 将 JSON 响 应 





解码 成 Go 的 值 。 











代码 清单 9-24 handlers /handlers_test.go: 第 41 行 到 第 49 行 

















:= struct { 
Name string 
Email string 


}{} 


if err := json.NewDecoder(rw.Body).Decode(&u); err != nil { 
t.Fatal("\tShould decode the response.", ballotX) 


} 
t.Log("\tShould decode the response.", checkMark)” 





在 代码 清单 9-24 的 第 41 行 ， 声 明了 一 个 匿名 结构 类 型 ， 使 用 这 个 类 
型 创建 了 名 为 u 的 变量 ， 并 初始 化 为 零 值 。 在 第 46 行 ， 使 用 json 包 将 
响应 的 JSON 文 档 解 码 到 变量 u 里。 如 果 解 码 失败 ， 单 元 测试 结束 ; 否 
则 ， 我 们 会 验证 解码 后 的 值 是 否 正 确 ， 如 代码 清单 9-25 所 示 。 


代码 清单 9-25 handlers /handlers_test.go: 第 51 行 到 第 63 行 





























if u.Name == "Bill" { 

t.Log("\tShould have a Name.", checkMark) 
} else { 

t.Error("\tShould have a Name.", ballotX, u.Name) 
} 


if u.Email == "bill@ardanstudios.com" { 


t.Log("\tShould have an Email.", checkMark) 
} else { 
t.Error("\tShould have an Email.", ballotX, u.Email) 





代码 清单 9-25 展 示 了 对 收 到 的 两 个 值 的 检测 。 在 第 51 行 ， 我 们 检 
测 Name 字段 的 值 是 否 为 "Bil11" ， 之 后 在 第 57 行 ， 检 查 Email 字段 的 值 
是 人 否 为 "bill@ardanstudios.com"” 。 如 果 这 些 值 都 匹配 ， 单 元 测试 通 
过 ; 否则， 单元 测试 失败 。 这 两 个 检测 使 用 Error 方法 来 报告 失败 ， 所 
以 不 管 检测 结果 如 何 ， 两 个 字段 都 会 被 检测 。 


9.2 示例 


Go 语言 很 重视 给 代码 编写 合适 的 文档 。 专门 内 置 了 godoc 工具 来 
从 代码 直接 生成 文档 。 在 第 3 章 中 ， 我 们 已 经 学 过 如 何 使 用 godoc 工具 
来 生成 包 的 文档 。 这 个 工具 的 另 一 个 特性 是 示例 代码 。 示 例 代 人 码 给 文档 
和 测试 都 增加 了 一 个 可 以 扩展 的 维度 。 


如 果 使 用 浏览 器 来 浏览 json 包 的 Go 文档 ， 会 看 到 类 似 图 9-8 所 示 的 











文档 





€ CC | golang.org/pkg/encoding/ison/ 


type UnsupportedValueError 
func (e *UnsupportedValueErron Error() string 


Examples 


Decoder 
Indent 
Marshal 
RawMessage 
Unmarshal 


Package files 





decode.go encode.go fold.go indent.go scanner.go stream.go tags.go 


图 9-8 包 Jjson 的 示例 代码 列表 


包 json 含有 5 个 示例 ， 这 些 示 例 都 会 在 这 个 包 的 Go 文档 里 有 展示 。 
如 果 选 中 第 一 个 示例 ， 会 看 到 一 段 示 例 代码 ， 如 图 9-9 所 示 。 





€ CC! | golang.org/pkg/encoding/json/#example_Decoder @ 
v Example 


This example uses a Decoder to decode a stream of distinct JSON values. 


package main 


import ( 
"encoding/json" 
a fmt"' 
a i0" 
a log" 
"strings" 


) 


func main() { 
const jsonStream = 、 
{"Name": "Ed", "Text": "Knock knock."} 
{"Name": "Sam", "Text": "Who's there?"} 
"Name"s "Ed “Text"s “GO Tmt 
{"Name": "Sam", "Text": "Go fmt who?"} 
{"Name": "Ed", "Text": "Go fmt yourself!"} 


type Message struct { 


Name, Text string 
} 
dec := json.NewDecoder(strings.NewReader(jsonStream)) 
for { 
var m Message 
if err := dec.Decode(sm); err == io,EOF { 
break 
} else if err != nil { 
log.Fatal(err) 


fmt.Printf("%s: %s\n", m.Name, m.Text) 





图 9-9 Go 文档 里 显示 的 Decoder 示 例 视图 


开发 人 员 可 以 创建 目 己 的 示例 ， 并 且 在 包 的 Go 文档 里 展示 。 让 我 
们 看 一 个 来 和 目前 一 节 例子 的 SendJSON 函数 的 示例 ， 如 代码 清单 9-26 所 
外。 














代码 清单 9-26 handlers_example_test.go 





81 // 这 个 示例 程序 展示 如 何 编写 基础 示例 
62 package handlers_ test 


64 import ( 

65 "encoding/json" 

66 "fmt" 

67 "log" 

608 "net/http" 

069 "net/http/httptest" 
16 ) 

11 





12 // ExampleSendJSON 提 供 了 基础 示例 
13 func ExampleSendJSON() { 





14 r, _ := http.NewRequest("GET", "/sendjson", nil) 
15 rw := httptest.NewRecorder() 

16 http.DefaultServeMux.ServeHTTP(rw, r) 

17 

18 var U struct { 

19 Name string 

20 Email string 

21 } 

22 

23 if err := json.NewDecoder(w.Body) .Decode(&u); err != nil { 
24 log.Println("ERROR:", err) 

25 } 

26 

27 // 使 用 fmt 将 结果 写 到 stdout 来 检测 输出 

28 fmt.Println(u) 

29 // Output: 

36 // {Bill bill@ardanstudios.com} 

31 } 





示例 基于 已 经 存在 的 函数 或 者 方法 。 我 们 需要 使 用 Example 代 符 
Test 作为 函数 名 的 开始 。 在 代码 清单 9-26 的 第 13 行 中 ， 示 例 代 码 的 名 


字 是 ExampleSendJSON。 


对 于 示例 代码 ， 需 要 遵守 一 个 规划。 示例 代码 的 函数 名 字 必 须 基于 
己 经 存在 的 公开 的 函数 或 者 方法 。 我 们 的 示例 的 名 字 基 于 handlers 包 
里 公开 的 SendJSON 函数 。 如 果 没 有 使 用 已 经 存在 的 函数 或 者 方法 ， 这 
个 示例 就 不 会 显示 在 包 的 Go 文档 里 。 


写 示 例 代 码 的 目的 是 展示 茶 个 函数 或 者 方法 的 特定 使 用 方法 。 为 了 
判断 测试 是 成 功 还 是 失败 ， 需 要 将 程序 最 终 的 输出 和 示例 函数 底部 列 出 
的 输出 做 比较 ， 如 代码 清单 9-27 所 示 。 

















代码 清单 9-27 handlers_example_test.go: 第 27 行 到 第 31 行 


// 使 用 fmt 将 结果 写 到 stdout 来 检测 输出 
fmt.Println(u) 
// Output: 


// {Bill bill@ardanstudios.com} 





在 代码 清单 9-27 的 第 28 行 ， 代 码 使 用 fmt .Println 输出 变量 u 的 值 
到 标准 输出 。 变 量 u 的 值 在 调用 /sendjson 服务 端点 之 前 使 用 零 值 初始 
化 。 在 第 29 行 中 ， 有 一 段 带 有 Output: 的 注释 。 





这 个 Output: 标记 用 来 在 文档 中 标记 出 示例 函数 运行 后 期 望 的 输 
出 。Go 的 测试 框架 知道 如 何 比较 注释 里 的 期 望 输出 和 标准 输出 的 最 终 
和 输出。 如 宁 两 者 匹配 ， 这 个 示例 作为 测试 就 会 通过 ， 并 加 入 到 包 的 Go 
文档 里 。 如 有 果 输 出 不 匹配 ， 这 个 示例 作为 测试 就 会 失败 。 


如 果 启 动 一 个 本 地 的 godoc 服务 器 (godoc -http=":3666" ) ， 
并 找到 handlers 包 ， 就 能 看 到 包含 示例 的 文档 ， 如 图 9-10 所 示 。 





Overview ~ 
Package handlers provides the endpoints for the web service. 


Index v 


func Routes() 
func SendJSON(rw http.ResponseWriter, r *http.Request) 


Examples 
SendJSON 
Package files 


handlers.go 


图 9-10 handlers 包 的 godoc 视图 


在 图 9-10 里 可 以 看 到 handlers 包 的 文档 里 展示 了 SendJSON 函数 的 
示例 。 如 果 选 中 这 个 Send]JSON 链接 ， 文 档 束 会 展示 这 段 代 人 码 ， 如 图 9- 





11 所 示 。 





func SendJSON 
func SendJSON(rw http.ResponseWriter, r *http,.Request) 


SendJSON returns a simple JSON document. 
v Example 
ExampleSendJSON provides a basic example test example. 


Code: 


r, _ := http.NewRequest("GET", "/sendjson", nil) 
WwW := httptest,NewRecorder( ) 
http.DefaultServeMux.ServeHTTP(w, r) 

var U struct { 


Name string 
Email string 


log.Println("ERROR:", err) 
} 


fmt.Printtn(u) 
Output: 


{Bill bill@ardanstudios.com} 





图 9-11 在 godoc 里 显示 完整 的 示例 代码 


if err := json.NewDecoder(w.Body).Decode(&u); err != nil { 





图 9-11 展 示 了 示例 的 一 组 完整 文档 ， 包 括 代 码 和 期 望 的 输出 。 由 于 
这 个 示例 也 是 测试 的 一 部 分 ， 可 以 使 用 go test 工具 来 运行 这 个 示例 函 


数 ， 如 图 9-12 所 示 。 


$ go test -Vv -run="ExampleSendJSON" 
=== RUN: ExampLeSendJSON 
--- PASS: ExampLeSendJSON (0.00s) 


PASS 
OK github.com/goinaction/code/chapter9/listingl7/handlers 0.008s 





图 9-12 ”运行 示例 代码 


运行 测试 后 ， 可 以 看 到 测试 通过 了 。 这 次 运行 测试 时 ， 使 用 -run 
选项 指定 了 特定 的 函数 ExampleSendJSON 。-run 选项 接受 任意 的 正则 
表达 式 ， 来 过 滤 要 运行 的 测试 函数 。 这 个 选项 既 支 持 单元 测试 ， 也 支持 
示例 函数 。 如 果 示 例 运 行 失败 ， 输 出 会 与 图 9-13 所 示 的 样子 类 似 。 


$ go test -Vv -run="ExampLeSendJSON" 
=== RUN: ExampLeSendJSON 

--- FAIL: ExampLeSendJSON (0.00s) 
got: 

{Lisa lisa@gmail .com} 


want: 

{Bill bill@ardanstudios .com} 

FAIL 

exit status 1 

FAIL github.com/goinaction/code/chapter9/listingl7/handlers 0.006s 





图 9-13 ”示例 运行 失败 


i 如 果 示 例 运行 失败 ，go test 会 同时 展示 出 生成 的 输出 ， 以 及 期 望 
和 输出 。 


9.3 ”基准 测试 


基准 测试 是 一 种 测试 代码 性 能 的 方法 。 想 要 测试 解雇 同一 问题 的 不 
同方 案 的 性 能 ， 以 及 碍 看 哪 种 解决 方案 的 性 能 更 好 时 ， 基 准 测 试 就 会 很 
有 用 。 基 准 测试 也 可 以 用 来 识别 菜 段 代码 的 CPU 或 者 内 存 效 率 问 题 ， 而 
这 上 段 代码 的 效率 可 能 会 严重 影响 整个 应 用 程序 的 性 能 。 许 多 开发 人 员 会 
用 基准 测试 来 测试 不 同 的 并 发 模式 ， 或 者 用 基准 测试 来 辅助 配置 工作 池 
的 数量 ， 以 保证 能 最 大 化 系统 的 否 叶 量 。 


让 我 们 看 一 组 基准 测试 的 函数 ， 找 出 将 整数 值 转 为 字符 串 的 最 快 方 





法 。 在 标准 库 里 ， 有 3 种 方法 可 以 将 一 个 整数 值 转 为 字符 串 。 
代码 清单 9-28 展 示 了 listing28_test.go 基 准 测试 开始 的 几 行 代码 。 


代码 清单 9-28 ”listing28_test.go: 第 01 行 到 第 10 行 









































// 用 来 检测 要 将 整数 值 转 为 字符 串 ， 使 用 哪个 函数 会 更 好 的 基准 
// 测试 示例 。 先 使 用 fmt .Sprintf 函 数 ， 然 后 使 用 
// strconv.FormatInt 函 数 ， 最 后 使 用 strconv .Itoa 
package listing28 test 
































import ( 
"fmt" 
"strconv" 
"testing" 





和 单元 测试 文件 一 样 ， 基 准 测 试 的 文件 名 也 必须 以 _test.go 结 
尾 。 同 时 也 必须 导入 testing 包 。 接 下 来 ， 让 我 们 看 一 下 其 中 一 个 基准 
测试 函数 ， 如 代码 清单 9-29 所 示 。 














代码 清单 9-29 listing28_test.go: 第 12 行 到 第 22 行 

















// Benchmarksprintf 对 fmt.Sprintf 函 数 

// 进行 基准 测试 

func BenchmarkSprintf(b *testing.B) { 
number := 16 























b.ResetTimer() 


for i := 606; i < b.N; i++ 
fmt.Sprintf("%d", number) 


} 





在 代码 清单 9-29 的 第 14 行 ， 可 以 看 到 第 一 个 基准 测试 函数 ， 名 
为 BenchmarkSprintf 。 基 准 测试 函数 必须 以 Benchmark 开头 ， 接 受 
一 个 指向 testing.B 类 型 的 指针 作为 唯一 参数 。 为 了 让 基准 测试 框架 能 
准确 测试 性 能 ， 它 必须 在 一 段 时 间 内 反复 运行 这 段 代 人 码 ， 所 以 这 里 使 用 
了 for 循环 ， 如 代码 清单 9-30 所 示 。 




















代码 清单 9-30 ”listing28_test.go: 第 19 行 到 第 22 行 








for i := 0; i < b.N; i++ 
fmt.Sprintf("%d", number) 





代码 清单 9-30 第 19 行 的 for 循环 展示 了 如 何 使 用 b.N 的 值 。 在 第 20 
行 ， 调 用 了 fmt 包 里 的 Sprintf 函数 。 这 个 函数 是 将 要 测试 的 将 整数 值 
转 为 字符 串 的 函数 。 


基准 测试 框架 默认 会 在 持续 1 秒 的 时 间 内 ， 反 复 调用 需要 测试 的 函 
数 。 训 试 框架 每 次 调用 测试 函数 时 ， 都 会 增加 b.N 的 值 。 第 一 次 调用 
时 ，b.N 的 值 为 1 。 需 要 注意 ， 一 定 要 将 所 有 要 进行 基准 测试 的 代码 都 
“0 并 且 循 环 要 使 用 b.N 的 值 。 人 否则 ， 测 试 的 结案 是 不 可 靠 





需要 加 入 -bench 选项 ， 如 代 
码 清单 9-31 所 示 。 














代码 清单 9-31 运行 基准 测试 








go test -v -Pun="none” -bench="BenchmarkSprintf" 





在 这 次 go test 调用 里 ， 我 们 给 -run 选项 传递 了 字符 串 "none"， 
来 保证 在 运行 制订 的 基准 测试 函数 之 前 没有 单元 测试 会 被 运行 。 这 两 个 
选项 都 可 以 接受 正则 表达 式 ， 来 决定 需要 运行 哪些 测试 。 由 于 例子 里 没 
有 单元 测试 函数 的 名 字 中 有 none ， 所 以 使 用 none 可 以 排除 所 有 的 单元 
测试 。 发 出 这 个 命令 后 ， 得 到 图 9-14 所 示 的 输出 。 








$ go test -v -run="none" -bench="BenchmarkSprintf" 
testing: warning: no tests to run 
PASS 


BenchmarkSprintf 5000000 258 ns/op 
ok github.com/goinaction/code/chapter9/listing28 1.562s 
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图 9-14 ”运行 单个 基准 测试 


这 个 输出 一 开始 明确 了 没有 单元 测试 被 运行 ， 之 后 开始 运 
行 BenchmarkSprintf 基准 测试 。 在 输出 PASS 之 后 ， 可 以 看 到 运行 这 
个 基准 测试 函数 的 结果 。 第 一 个 数字 56866666 表示 在 循环 中 的 代码 被 执 
行 的 次 数 。 在 这 个 例子 里 ， 一 共 执 行 了 500 万 次 。 之 后 的 数字 表示 代码 
的 性 能 ， 单 位 为 每 次 操作 消耗 的 纳 秒 (ns) 数 。 这 个 数字 展示 了 这 次 测 
试 ， 使 用 Sprintf 函数 平均 每 次 花费 了 258 纳 秒 。 


最 后 ， 运 行 基准 测试 输出 了 ok ， 表 明基 准 测试 正常 结束 。 之 后 显 
示 的 是 被 执行 的 代码 文件 的 名 字 。 最 后 ， 输 出 运行 基准 测试 总 共 消 耗 的 
时 间 。 上 默认 情况 下 ， 基 准 测 试 的 最 小 运行 时 间 是 1 秒 。 你 会 看 到 这 个 测 
试 框架 持续 运行 了 大 约 1.5 秒 。 如 果 想 让 运行 时 间 更 长 ， 可 以 使 用 男 一 
个 名 为 -benchtime 的 选项 来 更 改 测试 执行 的 最 短 时 间 。 让 我 们 再 次 运 
行 这 个 测试 ， 这 次 持续 执行 3 秒 〈 见 图 9-15) 。 

















$ go test -Vv -run="none' -bench="BenchmarkSprintf" -benchtime="3s" 
testing: warning: no tests to run 
PASS 


BenchmarkSprintf 200090000 256 ns/op 
OK github.com/goinaction/code/chapter9/listing28 5.384s 

















图 9-15 ”使 用 -benchtime 选 项 来 运行 基准 测试 











这 次 Sprintf 函数 运行 了 2000 万 次 ， 持 续 了 5.384 秒 。 这 个 函数 的 
执行 性 能 并 没有 太 大 的 变化 ， 这 次 的 性 能 是 每 次 操作 消耗 256 纳 秒 。 有 
时 候 ， 增 加 基准 测试 的 时 间 ， 会 得 到 更 加 精确 的 性 能 结果 。 对 大 多 数 测 
试 来 说 ， 超 过 3 秒 的 基准 测试 并 不 会 改变 测试 的 精确 度 。 只 是 每 次 基准 
测试 的 结果 会 稍 有 不 同 。 


让 我 们 看 另外 两 个 基准 测试 函数 ， 并 一 起 运行 这 3 个 基准 测试 ， 看 
看 哪 种 将 整数 值 转换 为 字符 串 的 方法 最 快 ， 如 代码 清单 9-32 所 示 。 


代码 清单 9-32 ”listing28_test.go: 第 24 行 到 第 46 行 

















24 // BenchmarkFormat 对 strconv.FormatInt 函 数 











25 // 进行 基准 测试 
26 func BenchmarkFormat(b *testing.B) { 














27 number := int64(16) 
28 
29 b.ResetTimer() 


31 for i := 606; i < b.N; i++ 

32 strconv.FormatInt(number, 106) 
33 } 

34 } 


36 // BenchmarkItoa 对 strconv.Itoa 汤 数 
37 // 进行 基准 测试 
38 func BenchmarkItoa(b *testing.B) { 























39 number := 16 

40 

41 b.ResetTimer() 

42 

43 for i := 606; i < b.N; i++ 
44 strconv.Itoa(number) 
45 } 

46 } 








代码 清单 9-32 展 示 了 男 外 两 个 基准 测试 隙 数 。 邓 
数 BenchmarkFormat 测试 了 strconv 包 里 的 FormatInt 函数 ， 而 函 
数 BenchmarkItoa 测试 了 同样 来 自 strconv 包 的 Itoa 函数 。 这 两 个 基 
准 测 试 函数 的 模式 和 BenchmarkSprintf 函数 的 模式 很 类 似 。 函 数 内 部 
的 for 循环 使 用 b .N 来 控制 每 次 调用 时 过 代 的 次 数 。 





我 们 之 前 一 直 没 有 提 到 这 3 个 基准 测试 里 面 调用 b.ResetTimer 的 
作用 。 在 代码 开始 执行 循环 之 前 需要 进行 初始 化 时 ， 这 个 方法 用 来 重 置 
计时 占 ， 保 证 测试 代码 执行 前 的 初始 化 代码 ， 不 会 干扰 计时 右 的 结果 。 
为 了 保证 得 到 的 测试 结果 尽量 精确 ， 需 要 使 用 这 个 函数 来 跳 过 初始 化 代 
码 的 执行 时 间 。 


让 这 3 个 函数 至 少 运行 3 秒 后 ， 我 们 得 到 图 9-16 所 示 的 结 





$ go test -Vv -run="none" -bench=. -benchtime="3s" 
testing: warning: no tests to run 

PASS 

BenchmarkSprintf 20000000 257 ns/op 


BenchmarkFormat 100000000 45.9 ns/op 
BenchmarkItoa ololololololo 49.4 ns/op 
ok github.com/goinaction/code/chapter9/listing28 15.057s 











图 9-16 运行 所 有 3 个 基准 测试 




















这 个 结果 展示 了 BenchmarkFormat 测试 函数 运行 的 速度 最 快 ， 
次 操作 耗 时 45.9 纳 秒 。 紧 随 其 后 的 是 BenchmarkItoa ， 每 次 操作 耗 时 
49.4 ns。 这 两 个 函数 的 性 能 都 比 Sprintf 函数 快 得 多 。 


运行 基准 测试 时 ， 另 一 个 很 有 用 的 选项 是 -benchmenm 选项 。 这 个 选 
项 可 以 提供 每 次 操作 分 配 内 存 的 次 数 ， 以 及 总 共 分 配 内 存 的 字 节 数 。 让 
我 们 看 一 下 如 何 使 用 这 个 选项 〈 见 图 9-17) 。 


$ go test -Vv -run="none" -bench=, -benchtime="3s" -benchmem 


testing: warning: no tests to run 

PASS 

BenchmarkSprintf 26000060 255 ns/op 16 B/op 2 allocs/op 
BenchmarkFormat 100000000 45.8 ns/op 2 B/op 1 allocs/op 
BenchmarkItoa 1009000000 49.5 ns/op 2 B/op 1 allocs/op 

ok github.com/goinaction/code/chapter9/listing28 ”15.008s 





图 9-17 使 用 -benchmem 选 项 来 运行 基准 测试 


这 次 输出 的 结果 会 多 出 两 组 新 的 数值 : 一 组 数值 的 单位 是 B/op ， 
另 一 组 的 单位 是 allocs/op 。 单 位 为 allocs/op 的 值 表示 每 次 操作 从 
堆 上 分 配 内 存 的 次 数 。 你 可 以 看 到 Sprintf 函数 每 次 操作 都 会 从 堆 上 分 
配 两 个 值 ， 而 另外 两 个 函数 每 次 操作 只 会 分 配 一 个 值 。 单 位 为 B/op 的 
值 表示 每 次 操作 分 配 的 字 节 数 。 你 可 以 看 到 Sprintf 函数 两 次 分 配 总 共 
16 字 节 的 内 存 ， 而 另外 两 个 函数 每 次 操作 只 会 分 配 2 字 节 的 内 
子 。 

















在 运行 单元 测试 和 基准 测试 时 ， 还 有 很 多 选项 可 以 用 。 建 议 读者 碍 
看 一 人 吉 所 有 选项 ， 以 便 在 编写 自己 的 包 和 工程 时 ， 充 分 利用 测试 框架 。 
社区 希望 包 的 作者 在 正式 发 布 包 的 时 候 提 供 足 够 的 测试 。 





9.4 ”小结 


测试 功能 被 内 置 到 Go 语言 中 ，Go 语 言 提供 了 必要 的 测试 工具 。 
go test 工具 用 来 运行 测试 。 

测试 文件 总 是 以 _test.go 作 为 文件 名 的 结尾 。 

表 组 测试 是 利用 一 个 测试 函数 测试 多 组 值 的 好 办 法 。 

包 中 的 示例 代码 ， 既 能 用 于 测试 ， 也 能 用 于 文档 。 

基准 测试 提供 了 探查 代码 性 能 的 机 制 。 





欢迎 来 到 异步 社区 ! 


异步 社区 的 来 历 


异步 社区 (www.epubit.com.cn) 是 人 民 邮 电 出 版 社 旗 下 IT 专业 网 书 旗 
舰 社区 ， 于 2015 年 8 月 上 线 运 营 。 


异步 社区 依托 于 人 民 邮 电 出 版 社 20 余 年 的 开 专 业 优质 出 版 资源 和 编 
辑 宋 划 团队 ， 打 造 传统 出 版 与 电子 出 版 和 目 出 版 结合 、 纸 质 书 与 电子 书 
结合 、 传 统 印刷 与 POD 按 需 印 刷 结 合 的 出 版 平台 ， 提 供 最 新 技术 资讯 ， 
为 作者 和 读者 打造 交流 互动 的 平台 。 
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U 伍 新 改版 ， 狐 新 面 狐 迎 接 201 答谢 社区 用 户 


即日 起 到 定 过 由 了 
1 明 26 号 | 于 i 有 电子 书 8 折 1 你 





办 前 庙 开 发 ‘©. 数据 科学 贡 的 程 语 言 Ey 移动 开发 企 游戏 开发 


免费 电子 书 


Free eBook 








我 要 写 书 


Write for Us 











Python 机 右 学 习 一 预 贝 时 斯 方法 : 儿 宝 内 姐 。 机 器 学 习 项 目 开 发 全 成 。 贝 时 斯 思 堆 : 统计 建 要 > 
型 分 析 核心 算法 与 贝 叶 斯 推 新 的 Python 学 习 法 近期 活动 


任 区 里 都 有 什么 ? 
购买 图 书 

我 们 出 版 的 图 书 涵盖 主流 IT 技术 ， 在 编程 语言 、Web 技 术 、 数 据 科 
学 等 领域 有 众多 经 典 畅 销 图 书 。 社 区 现 已 上 线 图 书 1000 余 种 ， 电 子 书 
400 多 种 ， 部 分 新 书 实现 纸 书 、 电 子 书 同步 出 版 。 我 们 还 会 定期 发 布 新 
书 书 讯 。 
下 载 资 源 

社区 内 提供 随 书 附 赠 的 资源 ， 如 书 中 的 案例 或 程序 源 代码 。 


另外 ， 社 区 还 提供 了 大 量 的 免费 电子 书 ， 只 要 注册 成 为 社区 用 户 束 
可 以 免费 下 载 。 


与 作 译 者 互动 


很 多 图 书 的 作 译 者 已 经 入 驻 社 区 ， 您 可 以 关注 他 们 ， 咨 询 技术 问 
题 ， 可 以 阅读 不 断 更 新 的 技术 文章 ， 听 作 译 者 和 编辑 畅 聊 好 书 背 后 有 趣 
的 故事 ， 还 可 以 参与 社区 的 作者 访谈 栏目 ， 回 您 关注 的 作者 提出 采访 题 
目 。 


灵活 优惠 的 购书 


您 可 以 方便 地 下 单 购买 纸 质 图 书 或 电子 图 书 ， 纸 质 图 书 直接 从 人 民 
邮电 出 版 社 书 库 发 贷 ， 电 子 书 提供 多 种 阅读 格式 。 


对 于 重 磅 新 书 ， 社 区 提供 预 售 和 新 书 首发 服务 ， 用 户 可 以 第 一 时 间 
买 到 心仪 的 新 书 。 

用 户 帐 户 中 的 积分 可 以 用 于 购书 优惠 。100 积 分 =1 元 ， 购 买 图 书 
时 ， 在 ”EE3 里 项 入 可 使 用 的 积分 数值 ， 即 可 扣 减 相应 金额 。 


特别 优惠 


购买 本 电子 书 的 读者 专 享 异步 社区 优惠 券 。 使 用 方法 : 注册 成 为 社区 用 户 ， 在 下 单 购书 
时 输入 “57AWG”， 然 后 点 击 “ 使 用 优惠 码 ” 即 可 享受 电子 书 8 折 优 惠 ( 本 优惠 券 只 可 使 用 一 

































































1 次 ) 。 
纸 电 图 书 组 合 购买 


社区 独家 提供 纸 质 图 书 和 电子 书 组 合 购 买方 式 ， 价 格 优惠 ， 一 次 购 
买 ， 多 种 阅读 选择 。 


Wireshark 网 络 分 析 的 艺术 本 书 作 译 省 


本 而 滨 
人 Linpeiman 过 
一 
算 机 科学 > 安全 与 加 密 > 网 洛 安 全 
NS i 3 上 海 
Wireshar 最 流行 的 网 阁 包 分析 ， 它 上 手 简单 ， 无 需 培 训 敦 可 入 门 。 很 各 i 
苇 手 # 到 Wireshark 都 能 迎刃而解 ， 1.0K 经 验 值 
书 抠 运 的 网 闭 包 来 自 真 实 场 好 , 经 此 目 接地 气 。 讲 解 时 
pf 
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社区 里 还 可 以 做 什么 


提交 勘误 


您 可 以 在 图 书页 面 下 方 提交 勘误 ， 每 条 勘误 被 确 认 后 可 以 获得 100 
积分 。 热 心 勘误 的 读者 还 有 机 会 参与 书稿 的 审 校 和 翻译 工作 。 


写作 


社区 提供 基于 Markdown 的 写作 环境 ， 喜 欢 写作 的 您 可 以 在 此 一 试 
身手 ， 在 社区 里 分 享 您 的 技术 心得 和 读书 体会 ， 更 可 以 体验 自 出 版 的 乐 





趣 ， 轻 松 实现 出 版 的 梦想 。 


0 
服务 。 


会 议 活动 早 知道 
您 可 以 掌握 IT 圈 的 技术 会 议 资 讯 ， 更 有 机 会 免费 获 赠 大 会 门票 。 
加 入 异步 


扫描 任意 二 维 码 都 能 找到 我 们 : 





异步 社区 





微 信 服务 号 











QQ 群 : 368449889 


社区 网 址 : www.epubit.com.cn 


官方 微 信 : 异步 社区 


官方 微 博 : @ 人 邮 寞 步 社 区 ，@ 人 民 邮 电 出 版 社 -信息 技术 分 社 


投稿 改 咨询 : ”contact@epubit.com.cn 


